---
title: "API de vérification de vote : intégration Azuriom"
date: 2026-08-13
author: "Clément Reynaud"
---

# API de vérification de vote : intégration Azuriom

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.