Nos APIs

Interfaces de Programmation Informatique (API) en PHP

Récompenser les votants

Notre système (facultatif) permet à vos joueurs d'être récompensés lorsqu'ils votent pour votre serveur sur Top Vote.
Vous pouvez, en échange du vote, proposer un lot de votre choix, tel que des points sur la boutique de votre serveur ou une clé de Box.

Dans le formulaire de configuration de votre serveur, il vous est possible de configurer un lien de récompense, ce lien devra posséder notre script, disponible ci-dessous :
Ce script est conseillé pour des raisons de sécurité. Il peut éviter à vos joueurs d'être récompenser plusieurs fois pour un seul vote.

Code PHP :
‹?php
$voteAPI_id = 'ID'; // ID de votre serveur
$voteAPI_ip = htmlentities($_GET['ip']); // Adresse IP du joueur votant
$voteAPI_username = htmlentities($_GET['info']); // FACULTATIF - Pseudonyme du joueur

if(!empty($voteAPI_username)) {
$voteAPIinfo = "".$voteAPI_id."_".$voteAPI_ip."_".$voteAPI_username."";
} else {
$voteAPIinfo = "".$voteAPI_id."_".$voteAPI_ip."";
}

$voteAPI = file_get_contents("https://api.top.vote/fr/verif/".$voteAPIinfo."");
$voteAPI = trim($voteAPI);

if($voteAPI == 'true') {
// Le vote est validé
// Variables de récompenses à insérer ici
} else {
// Le vote n'est pas validé.
}
?>

Si l'utilisateur a voté durant ces 60 dernières secondes, l'API retournera la valeur true et le joueur votant sera ainsi récompensé.


Votes reçus

Il vous est possible d'afficher sur votre serveur le nombre de nombre de votes que votre serveur a actuellement reçu grâce au script, disponible ci-dessous :

Code PHP :
‹?php
$voteAPI_id = 'ID'; // ID de votre serveur

$voteAPI = file_get_contents("https://api.top.vote/fr/votes/".$voteAPI_id."");
echo $voteAPI;
?>

Le résultat vous indiquera du nombre de votes que vous avez actuellement reçu pour votre serveur. Exemple: 81.