L’API permet à ton émulateur ou à ton site de vérifier les votes de tes joueurs. Ta clé API et l’identifiant de ton serveur se trouvent dans ton espace Dofus, sous chacun de tes serveurs. Garde la clé secrète : ne l’utilise que côté serveur.
Tu venais de serveur-prive-dofus.fr ? Tes identifiants et ta clé n’ont pas changé. Remplace seulement le début de l’adresse par https://www.liste-serveurs.fr/dofus/api.
Vérification simple (compatible serveur-prive.net)
GET https://www.liste-serveurs.fr/dofus/api/vote/json/{id}/{ip}
Même format que l’API de serveur-prive.net : si ton plugin de vote la gère déjà, remplace simplement l’adresse. {id} est l’identifiant de ton serveur. Aucune clé n’est nécessaire.
{ "status": 1, "voted_at": "2026-11-03T14:12:09Z", "next_vote_at": "2026-11-03T15:42:09Z" }
status vaut 1 si cette IP a voté pour ton serveur dans la dernière heure et demie, 0 sinon.
Vérifier le vote d’une IP (avec clé)
GET https://www.liste-serveurs.fr/dofus/api/v1/{cle}/vote/{ip}
Indique si cette IP a voté pour ton serveur dans la dernière heure et demie, avec le pseudo saisi par le joueur.
{
"voted": true,
"voted_at": "2026-11-03T14:12:09Z",
"pseudo": "Bwork-du-71",
"next_vote_at": "2026-11-03T15:42:09Z"
}
Vérifier par pseudo en jeu (recommandé)
L’IP vue par ton émulateur n’est pas toujours celle du vote : beaucoup de box votent en IPv6 sur le web mais jouent en IPv4. La vérification par pseudo ne dépend pas de l’IP. Elle utilise le pseudo saisi au moment du vote, sans tenir compte des majuscules.
GET https://www.liste-serveurs.fr/dofus/api/vote/json/{id}/pseudo/{pseudo}
GET https://www.liste-serveurs.fr/dofus/api/v1/{cle}/pseudo/{pseudo}
Mêmes réponses que les vérifications par IP. Pense à encoder le pseudo dans l’adresse (espaces, accents).
Lister les votes récents
GET https://www.liste-serveurs.fr/dofus/api/v1/{cle}/votes?depuis={timestamp}
Renvoie jusqu’à 500 votes reçus depuis le timestamp Unix indiqué (24 dernières heures par défaut), du plus ancien au plus récent.
{
"server": "mon-serveur",
"votes": [
{ "id": 1532, "pseudo": "Bwork-du-71", "ip": "203.0.113.7", "voted_at": "2026-11-03T14:12:09Z" }
]
}
Notification de vote (sans interroger l’API)
Indique une adresse https dans ta fiche : à chaque vote, on lui envoie une requête POST en JSON.
{
"event": "vote",
"vote_id": 1532,
"server_id": 12,
"pseudo": "Bwork-du-71",
"ip": "203.0.113.7",
"voted_at": "2026-11-03T14:12:09Z"
}
Pour vérifier que la requête vient bien de nous, calcule un HMAC-SHA256 de {X-SPD-Timestamp}.{corps de la requête} avec ton secret (affiché dans ton espace), puis compare-le à l’en-tête X-SPD-Signature (format sha256=…). Refuse les requêtes dont l’horodatage a plus de 5 minutes. Le bouton « Envoyer un vote de test » de ton espace envoie un événement "test".
Codes d’erreur
401: clé API inconnue.400: paramètre invalide.404: serveur inconnu ou pas encore publié.