Cette page explique comment relier votre serveur à votre site Azuriom (plugin Vote) pour que vos joueurs soient récompensés automatiquement, et comment utiliser notre API si vous développez votre propre intégration.
1. Dans votre fiche minecraft.fr
Bloc « Intégration » : choisissez Azuriom, renseignez l’URL de votre site Azuriom, puis enregistrez la fiche. Une fiche utilise soit Votifier, soit Azuriom, jamais les deux : c’est ce qui garantit une seule récompense par vote. En mode Azuriom, Votifier n’est plus sollicité ; en mode Votifier, notre API de vérification répond par une erreur.
2. Dans votre panel Azuriom
Plugins → Vote → Sites → Ajouter. Quatre réglages :
- URL du site : le lien affiché dans le bloc « Intégration » de votre fiche. Il se termine par
?pseudo={player}: Azuriom y substitue le pseudo du joueur, qui arrive sur votre fiche avec son pseudo déjà rempli. Ce champ est affiché à tous vos joueurs : n’y mettez rien d’autre. - Activer la vérification des votes : oui.
- Clé d’API : votre token serveur, à copier depuis l’encart « Accès API » de votre fiche. Ce champ n’est jamais affiché publiquement : il ne sert qu’aux échanges de serveur à serveur.
- 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.
minecraft.fr fait partie des annuaires reconnus par Azuriom. Si le champ « Clé d’API » n’apparaît pas après avoir activé la vérification, mettez à jour le plugin Vote.
Ne mettez jamais votre token dans le champ « URL du site » : il est public, votre clé serait visible de tous vos joueurs. Le bouton « Régénérer » de l’encart « Accès API » en crée une nouvelle si vous pensez qu’elle a fuité.
3. Comment se passe un vote
- Le joueur saisit son pseudo sur la page de vote de votre site et clique sur minecraft.fr.
- Il arrive sur votre fiche, pseudo pré-rempli, et vote. Le pseudo est insensible à la casse ; les pseudos Bedrock (Geyser) sont acceptés.
- Selon la version de votre plugin Vote, soit nous transmettons aussitôt le vote à votre site (pingback signé avec votre clé), soit votre site interroge notre API. Dans les deux cas, la récompense est distribuée pendant que la page de vote de votre site est ouverte.
4. Vérification de propriété
Dans le bloc « Vérification de propriété » de votre fiche, indiquez votre pseudo sur votre site Azuriom et cliquez sur « Vérifier via Azuriom » : nous envoyons un pingback de test, votre site le reconnaît grâce à la clé d’API, la fiche est vérifiée immédiatement. Changer l’URL du site Azuriom annule la vérification. Si votre plugin Vote ne gère pas encore le pingback minecraft.fr (message « mise à jour Azuriom en attente »), contactez-nous pour une validation manuelle.
5. 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_CLEVotre 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. La fiche doit être en intégration Azuriom.
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.403 integration_votifier— votre fiche est en intégration Votifier : choisissez Azuriom dans le bloc « Intégration ».429 rate_limited— trop de requêtes sur la minute écoulée.
6. Pingback (pour les développeurs)
En intégration Azuriom, chaque vote valide déclenche POST {URL de votre site}/api/vote/pingback/minecraft.fr avec trois champs : username, timestamp (epoch UNIX, en secondes) et signature = HMAC-SHA256 de username + ":" + timestamp avec votre clé d’API, en hexadécimal. Réponse attendue : 200 {"status":"ok"}. Un timestamp de plus de cinq minutes doit être refusé.
