Comment utiliser notre API ?
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";
}
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>";
}