Une API, c'est une adresse web qui répond avec des données au lieu d'une page. Tu tapes l'adresse d'un serveur TeamKit, elle te renvoie son état, ses joueurs, ses votes, en texte que ton site ou ton bot sait lire. Ce chapitre explique ce que tu peux en tirer et les quelques règles à suivre.
1. Essaie tout de suite #
Ouvre cette adresse dans ton navigateur :
https://www.teamkit.fr/api/v1/serveursTu vois la liste de tous les serveurs en service sur TeamKit. Chaque serveur a un slug : son nom
court dans les adresses, par exemple tk-eco-172. C'est la fin de l'adresse de sa page :
teamkit.fr/serveur/tk-eco-172.
Pour un seul serveur, ajoute son slug :
https://www.teamkit.fr/api/v1/serveurs/tk-eco-172✅ À retenir Le slug de ton serveur, c'est la fin de l'adresse de sa page sur teamkit.fr.
2. Ce que l'API donne #
Tout ce qui est déjà visible sur les pages publiques de teamkit.fr, et rien d'autre :
- pour un serveur : en ligne ou non, joueurs connectés et places, adresse pour rejoindre, record de joueurs, disponibilité, votes de la semaine et du mois, note des avis, prochain événement, sa communauté, ses bannières ;
- l'historique des joueurs sur 24 heures, 7 jours ou 30 jours ;
- les avis publiés et les événements à venir ;
- pour une communauté vérifiée : sa fiche, ses membres, si elle recrute, ses votes, ses serveurs ;
- les classements des serveurs et des communautés les plus votés, de la semaine ou du mois, et la Communauté du mois.
Rien de privé ne passe par là : pas d'identifiant Discord, pas d'e-mail, pas d'adresse IP de joueur.
3. Les règles #
| Règle | Pourquoi |
|---|---|
| 60 appels par minute au plus, depuis une même connexion | au-delà, l'API répond 429 et te dit combien de secondes attendre |
| Garde les réponses quelques secondes avant de redemander | les chiffres d'un serveur bougent au plus toutes les 30 secondes ; redemander plus souvent ne t'apprend rien |
| Cite TeamKit avec un lien quand tu affiches ces chiffres | c'est la seule chose qu'on demande en échange |
Toujours https://www. devant teamkit.fr |
sans le www, le site te redirige, et certains programmes ne suivent pas la redirection |
Chaque réponse porte deux en-têtes pour suivre ta limite : X-Quota-Restant (combien d'appels il
te reste cette minute) et X-Quota-Remise (l'heure de remise à zéro, en secondes Unix).
✅ À retenir Un appel par minute suffit pour un encart ou un bot. Tu es très loin de la limite.
4. Lire une réponse #
Les réponses sont en JSON, avec des noms de champs en français. Les dates sont au format
international avec le fuseau de Paris, par exemple 2026-10-09T22:55:30+02:00.
Les trois états possibles d'un serveur :
etat |
Ce que ça veut dire |
|---|---|
en_ligne |
le jeu tourne, on peut se connecter |
demarre |
il est en train de démarrer |
arrete |
il est arrêté |
Un champ que TeamKit ne connaît pas vaut null (par exemple carte pour un jeu sans carte).
5. Les erreurs #
| Code | Message | Ce qu'il faut faire |
|---|---|---|
404 |
Serveur introuvable (ou pas en service) | vérifie le slug ; un serveur libéré disparaît de l'API |
404 |
Communauté introuvable (ou pas encore vérifiée) | seules les communautés vérifiées sont publiques |
405 |
Cette API ne fait que lire | utilise une requête GET |
429 |
Trop d'appels | attends le nombre de secondes indiqué dans Retry-After |
500 |
Petit souci de notre côté | réessaie dans une minute ; si ça dure, préviens-nous sur le Discord TeamKit |
✔️ Checklist #
❓ Si ça ne marche pas #
- « Serveur introuvable » : copie le slug depuis l'adresse de la page de ton serveur, sans le
/serveur/devant. - Rien ne s'affiche dans ton programme mais le navigateur marche : vérifie le
https://www.. - Une autre question : le Discord TeamKit, salon des questions.