Documentation de l'API


API

L'ID de votre serveur peut être trouvé dans l'adresse de la page de votre serveur.
Par exemple, si la page de votre serveur est https://serveur-ark.com/123, l'ID de votre serveur est 123.

Cette API permet de vérifier les votes des utilisateurs. Elle peut s'utiliser de deux façons :


1) Vérification simple sans détails :

https://serveur-ark.com/api/1/vote/<votre ID serveur>/<IP à vérifier>

Cette adresse retournera 1 si l'IP a voté pour le serveur dans les 3 dernières heures, et 0 si elle n'a pas voté.

Exemple PHP :

<?php
$voted = @file_get_contents("https://serveur-ark.com/api/1/vote/123/1.2.3.4");
if ($voted > 0) {
    echo 'Cette IP a voté';
} else {
    echo 'Cette IP n\'a pas voté';
}


2) Vérification avec détails (JSON) :

https://serveur-ark.com/api/1/vote/<votre ID serveur>/<IP à vérifier>/json"

Cette adresse retourne ceci si l'IP a voté :
{"vote":"1","voted_at":"2019-03-04T17:36:02+01:00","time_until_next_vote":8520}

Le retour si l'IP n'a pas voté :
{"vote":"0"}

Exemple PHP :

<?php
$vote = json_decode(@file_get_contents("https://serveur-ark.com/api/1/vote/123/1.2.3.4/json"));
if ($vote->vote > 0) {
    echo 'Cette IP a voté, prochain vote possible dans ' . $vote->time_until_next_vote . ' secondes';
} else {
    echo 'Cette IP n\'a pas voté';
}