Documentation de notre API

Notre API vous permet de vérifier si un joueur a bien voté pour votre serveur.
Informations sur les votes :

  • Un vote = un point
  • Un vote toutes les 3 heures
  • Adresse de vote : https://yserveur.fr/serveur/<id du serveur>
  • Adresse de vote + pseudo prérempli : https://yserveur.fr/serveur/<id du serveur>/<pseudo>

NB : L'id de votre serveur se situe dans l'url sur la page détaillée de votre serveur (expl : Sur cette url, https://yserveur.fr/serveur/1, l'id du serveur est de 1).

a) CMS Minecraft directement intégré

Voici la liste des CMS où une vérification de vote est directement intégrée :

NB : Pour faire une demande d'ajout d'un autre CMS, veuillez envoyer un mail à l'adresse suivante : [email protected]

b) Vérification simple

La vérification est disponible via l'url ci-dessous :
https://yserveur.fr/api/vote/<id du serveur>/<ip du joueur>

Résultat renvoyé par l'adresse :

// Si le joueur a voté
{ "vote" : true }

// Si le joueur n'a pas voté
{ "vote" : false }

Exemple de code PHP :

<?php
// Exemple :
$result = @file_get_contents("https://yserveur.fr/api/vote/1/0.0.0.0");

$json = json_decode($result);
if ($json->vote == true) {
    echo 'Vous avez bien voté';
} else {
    echo 'Vous n\'avez pas voté';
}
?>

c) Vérification avec récupération des données

La vérification est disponible via l'url ci-dessous :
https://yserveur.fr/api/vote/data/<id du serveur>/<ip du joueur>

Résultat renvoyé par l'adresse :

// Si le joueur a voté
{
    "vote" : true,
    "pseudo" : "WIBOR",
    "voted_at" : "2022-05-17T17:20:31.000000Z",
    "next_vote_seconds" : 9520
}

// Si le joueur n'a pas voté
{
    "vote" : false
}

Exemple de code PHP :

<?php
$result = @file_get_contents("https://yserveur.fr/api/vote/data/1/0.0.0.0");

$json = json_decode($result);
if ($json->vote == true) {
    echo "{$json->pseudo} a voté, le prochain vote est dans {$json->next_vote_seconds} secondes";
} else {
    echo 'Vous n\'avez pas voté';
}
?>