L'API pour les joueurs
Construire tes propres outils (overlay de stream, bot, tableau de bord) avec un jeton personnel en lecture seule.
Mis à jour le 24 septembre 2026 par joueur-1800bd0d2 min de lectureSommaire
Tu veux afficher tes stats sur ton stream, faire un bot Discord pour ta faction ou un tableau de bord ? L'API publique du site te donne accès aux données du serveur, avec un jeton personnel. Tout se gère dans Paramètres › Accès API.
Trois règles avant de commencer
- Lecture seule : un jeton lit, il n'agit jamais. Il n'envoie aucun message, n'achète rien et ne change aucun réglage.
- Aucun pouvoir staff, jamais — même quand le jeton appartient à un compte du staff.
- Tes jetons sont personnels : qui en détient un lit ce que ton compte peut lire. Ne le montre jamais (stream, capture d'écran, code public) et révoque-le au moindre doute.
Créer un jeton
Dans Paramètres › Accès API, section Créer un jeton :
- Donne-lui un nom pour le reconnaître (« Overlay de stream »).
- Coche uniquement les droits dont ton outil a besoin :
| Droit | Ce qu'il permet de lire |
|---|---|
| Données publiques | classements, profils de joueurs et de factions, état du serveur — exactement ce qu'un visiteur voit sur le site (toujours inclus) |
| Mon joueur | ton compte Minecraft lié et ta faction ; sans ce droit, le jeton ne dit pas à qui il appartient |
| Ma faction | ta faction telle que ses membres la voient, avec ton rang |
| Mes événements | le flux en direct des événements de ton joueur et de ta faction (avec « Mon joueur » ou « Ma faction ») |
- Copie le jeton affiché : il ne sera plus jamais montré.
La page liste ensuite tes jetons (nom, droits, date de création, dernière utilisation) avec un bouton Révoquer : les outils qui l'utilisent cessent de fonctionner dès leur prochaine requête.
Utiliser le jeton
Ton outil envoie le jeton dans l'en-tête de chaque requête :
Authorization: Bearer <ton jeton>
- La référence complète de l'API (format OpenAPI) est accessible depuis la page Accès API.
- Pour le temps réel, l'API propose un flux WebSocket avec le même jeton : ton outil reçoit les événements au fil de l'eau (et rattrape ceux manqués après une coupure).
Les limites
La page Accès API affiche tes limites : requêtes par minute, requêtes par jour (remises à zéro à minuit UTC), rafale, connexions temps réel et abonnements par connexion, ainsi que ta consommation des 30 derniers jours.
Un grade d'abonnement n'augmente que le volume (requêtes et connexions), jamais les données : chaque joueur lit les mêmes informations, aussi fraîches. Les limites valent pour ton compte : tous tes jetons se les partagent.
Astuce — Quand ton outil dépasse une limite, l'API répond par un refus avec un en-tête
Retry-After: fais-le attendre ce délai avant de réessayer.
Pour aller plus loin
- Sécuriser ton compte — tes jetons et appareils.
- Les grades