API pour récupérer le status et informations d’un serveur Minecraft en PHP

Nous mettons à votre disposition une API vous permettant de récupérer toutes les données de votre serveur Minecraft: nombre de joueurs connectés, titre du serveur, nombre de votes, version du serveur, favicon du serveur.

Les informations collectées sont les mêmes que celles du widget visible dans l’onglet bannières.

Pour accéder à ces informations vous devez ajouter votre serveur sur notre top liste si cela n’est pas déjà fait.

 

API GET STATUS


Vous pouvez obtenir les informations de votre serveur au format JSON en utilisant ce lien. Remplacez XXXXXX par votre ID de serveur.

Ex: https://api.liste-serveurs-minecraft.org/widget/index.php?id=XXXXXX

Vous trouverez cet identifiant dans la barre d’adresse de votre navigateur (https://www.liste-serveurs-minecraft.org/mettre-en-avant/?idc=XXXXXX) lorsque vous cliquez sur le bouton « Mettre en avant » dans votre fiche serveur ou lorsque vous l’éditez.

 

Réponse de l’API Définition
ip IP et port du serveur
playerscount Nombre de joueurs connectés et slots max
version Version du serveur
votes Nombre de votes sur Liste-serveurs-minecraft.org
favicon Favicon image au format base64
description Titre du serveur avec les codes couleur
<?php
// Exemple avec PHP: Remplacez XXXXXX par l'ID de votre serveur
$server_id = "XXXXXX";

// On execute cURL (ne rien toucher ici)
$url="https://api.liste-serveurs-minecraft.org/widget/index.php?id=".$server_id;
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_URL,$url);
$result=json_decode(curl_exec($ch), true);
curl_close($ch);

if ($result){
  // Exemple pour le nombre de joueurs
  echo "Nombre de joueurs connectés: ".$result['playerscount'];	
  // Utilisez print_r($result); pour voir toutes les informations disponibles	
} else {
  echo "serveur introuvable";
}
?>