Cette page explique comment déclarer votre serveur dans le plugin Vote d’Azuriom, et comment utiliser notre API de vérification si vous développez votre propre intégration.

1. Déclarer minecraft.fr dans Azuriom

Dans votre panel : Plugins → Vote → Sites → Ajouter.

  • URL du site : le lien public de votre fiche sur minecraft.fr, celui que vous donnez à vos joueurs pour voter. Rien d’autre.
  • Délai entre deux votes : 180 minutes, pour correspondre à notre cooldown. Un délai plus court ferait croire à vos joueurs qu’ils peuvent revoter alors que nous refuserons le vote.

2. Vérification automatique : pas encore disponible

Azuriom ne sait vérifier que les annuaires enregistrés dans son propre code, et cette liste n’est pas modifiable depuis son panel : aucun champ ne permet d’y saisir une URL de vérification personnalisée.

La demande d’ajout de minecraft.fr est en cours auprès d’Azuriom. En attendant, déclarez-nous comme site de vote en laissant la vérification désactivée : vos joueurs voteront normalement, la récompense automatique arrivera ensuite.

Ne collez jamais votre token dans Azuriom. Le champ « URL du site » est le lien public envoyé à vos joueurs : votre clé y serait visible de tous.

3. Récompenser vos joueurs aujourd’hui

En attendant la vérification Azuriom, la méthode qui fonctionne dès maintenant est Votifier : configurez-le dans votre fiche, et votre serveur récompense le joueur à l’instant du vote. C’est le mode par défaut, vous n’avez rien à changer.

Le jour où la vérification Azuriom sera active, il faudra choisir une seule méthode dans le bloc « Configuration Votifier » de votre fiche — Votifier ou API — sous peine de récompenser le joueur deux fois pour un seul vote.

4. API de vérification (intégration maison)

Si vous développez votre propre intégration, notre API répond à :

GET https://minecraft.fr/wp-json/serveursmc/v1/votes/{pseudo}?api_key=VOTRE_CLE

Votre clé se trouve dans l’encart « Accès API » de votre fiche, en back-office. Elle est propre à votre serveur ; le bouton « Régénérer » en crée une nouvelle si vous pensez qu’elle a fuité. Cette clé transitant dans l’URL, réservez-la à des appels de serveur à serveur.

Le pseudo est insensible à la casse. Les pseudos Bedrock sont acceptés, espaces compris (encodez-les %20), et le point ajouté par Geyser est ignoré.

{ "user": "Keither", "has_voted": true,  "last_vote_at": "2026-08-12T14:05:02Z" }
{ "user": "Inconnu", "has_voted": false, "last_vote_at": null }

Un joueur qui n’a jamais voté renvoie has_voted: false avec un code 200 — jamais une erreur.

Codes d’erreur

  • 400 invalid_name — pseudo vide, mal encodé, ou contenant des caractères impossibles dans un pseudo.
  • 401 invalid_token — clé absente, tronquée ou inconnue.
  • 403 server_disabled — votre fiche est désactivée ou en attente. Un serveur simplement hors ligne continue, lui, de répondre normalement.
  • 429 rate_limited — trop de requêtes sur la minute écoulée.