Comment utiliser notre API ?

Verifier si un joueur a vote (pseudo/IP)

Pour verifier si un joueur a vote, utilisez l'URL ci-dessous en remplacant :

  • {idServeur} par l'ID de votre serveur.
  • {ip,Username} par l'IPv6 ou le pseudo du joueur.

L'ID de votre serveur se trouve a la fin de l'URL de votre lien de vote. (Ex: https://serveur-gta6.fr/server-nomserveur.1)

https://serveur-gta6.fr/api/checkVote/{idServeur}/{ip,Username}

Exemple d'utilisation en PHP :

Dans cet exemple, on recupere le resultat dans la variable $resultat. Pour lire le resultat (JSON), on le convertit en tableau. Ensuite, on teste simplement si la valeur de "success" est true !

Si le joueur a vote, vous pouvez aussi recuperer la valeur prochainVote (timestamp) pour afficher le temps restant avant le prochain vote.


$resultat = file_get_contents("https://votre-domaine.com/api/checkVote/1/Notch");
$jsonDecoded = json_decode($resultat, true);

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


// Optional: Remaining time before they can vote.

$dateProchainVote = new DateTime();
$dateProchainVote->setTimestamp($jsonDecoded['prochainVote']);
$ecart = $dateProchainVote->diff(new DateTime());
echo '<p>Le joueur pourra voter dans : ';
echo $ecart->h.' hour(s) ';
echo $ecart->i.' minute(s) ';
echo $ecart->s.' second(s) ';
echo '</p>';


}else{
    echo "Le joueur n'a pas vote";
}
Recuperer le top des votants

Pour recuperer la liste des meilleurs votants et leurs votes, utilisez l'URL ci-dessous en remplacant :

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

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

https://serveur-gta6.fr/api/topVotes/{idServeur}/{limit}

Exemple d'utilisation en PHP :

Dans cet exemple, on recupere le resultat dans la variable $resultat. Pour lire le resultat (JSON), on le convertit en tableau, puis on parcourt la liste complete des joueurs et de leurs votes.


	  $resultat = file_get_contents("https://votre-domaine.com/api/topVotes/1/30");
$jsonDecoded = json_decode($resultat, true);

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

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

}