Bienvenue sur Liste-Serveurs.fr !
Découvrez le classement des meilleurs serveurs Minecraft français.

Comment utiliser notre API ?

Vérifier si le joueur a bien voté (par pseudo/ip)

Pour savoir si un joueur a bien voté, il vous suffit juste d'utiliser l'URL ci-dessous en remplaçant:

  • {idServeur} par l'id de votre serveur.
  • {ip,Pseudo} par l'IPV6 ou le pseudo du joueur.

L'ID de votre serveur se trouve à la fin de l'URL de votre lien de vote. (Ex: http://listeserveurs.test/server-leserveur.1)

https://www.liste-serveurs.fr/api/checkVote/{idServeur}/{ip,Pseudo}

Exemple d'utilisation en PHP:

Dans cet exemple, nous récupérons le résultat retourné dans la variable $resultat. Pour pouvoir lire le résultat (en JSON), on converti celui-ci en tableau. Il ne reste plus qu'à tester si la valeur de "success" vaut bien true!

Si le joueur a voté, vous pouvez récupérer la valeur: prochainVote (timestamp) comme dans l'exemple ci-dessous pour afficher le temps restant avant la possibilité de voter.


$resultat = file_get_contents("https://www.liste-serveurs.fr/api/checkVote/1/Notch");
$jsonDecoded = json_decode($resultat, true);

if ($jsonDecoded['success'] === true) {
    echo "Le joueur a bien voté";


// Optionnel: Temps restant pour pouvoir voter.

$dateProchainVote = new DateTime();
$dateProchainVote->setTimestamp($jsonDecoded['prochainVote']);
$ecart = $dateProchainVote->diff(new DateTime());
echo '<p>Le joueur peut voter dans: ';
echo $ecart->h.' heure(s) ';
echo $ecart->i.' minutes(s) ';
echo $ecart->s.' secondes(s) ';
echo '</p>';


}else{
    echo "Le joueur n'a pas voté";
}
Récupérer les meilleurs votants

Pour récupérer la liste des meilleurs votants et leurs votes, il vous suffit juste d'utiliser l'URL ci-dessous en remplaçant:

  • {idServeur} par l'id de votre serveur.
  • {limit} par le nombre max de joueurs (max 30)

L'ID de votre serveur se trouve à la fin de l'URL de votre lien de vote. (Ex: http://listeserveurs.test/server-leserveur.1)

https://www.liste-serveurs.fr/api/topVotes/{idServeur}/{limit}

Exemple d'utilisation en PHP:

Dans cet exemple, nous récupérons le résultat retourné dans la variable $resultat. Pour pouvoir lire le résultat (en JSON), on converti celui-ci en tableau. Il ne reste plus qu'à retourner toute la liste (les joueurs) et leurs votes !


	  $resultat = file_get_contents("https://www.liste-serveurs.fr/api/topVotes/1/30");
$jsonDecoded = json_decode($resultat, true);

foreach($jsonDecoded["classement"] as $joueur){

   echo '<p>' . $joueur["pseudo"] . " - " . $joueur["votes"] . " votes </p>";

}