01. Introduction
L'API McServ permet aux administrateurs de serveurs de vérifier si un utilisateur a voté durant la journée calendaire en cours. La réinitialisation des votes s'effectue chaque jour à 00:00 (UTC).
02. Pourquoi utiliser l'API ?
FIABILITÉ ANTI-PERTE
Contrairement aux notifications Votifier qui peuvent être manquées si votre serveur est hors ligne, l'API permet une vérification à la demande lors de la connexion du joueur.
BOUTIQUES & WEBSTORES
Vérifiez le vote sur votre boutique web pour appliquer des réductions ou débloquer des achats sans que le joueur soit connecté en jeu.
STATS & DASHBOARDS
Affichez un rappel dynamique sur votre site ou launcher pour indiquer aux joueurs s'ils ont déjà soutenu le serveur aujourd'hui.
03. Récupérer votre Slug
Le slug est l'identifiant textuel permanent situé dans l'URL de votre serveur. Plus stable que l'ID numérique, il facilite la maintenance de vos scripts.
mcserv.org/serveurs/slug_de_votre_serveur→ Identifiant à extraire de votre URL publique McServ.
04. Points d'accès
slug/IPRéponse text/plain : 1 (a voté) ou 0 (aucun vote).
slug/IP/jsonRéponse JSON détaillée incluant le timestamp et la réinitialisation de minuit.
{
"vote": "1",
"voted_at": "2026-02-05T14:20:01Z",
"reset": true,
"next_in": 34799
}