Toutes les adresses, avec leurs réponses

Toutes les adresses commencent par https://www.teamkit.fr/api/v1. Elles se lisent avec une simple requête GET, sans clé. Les exemples viennent du serveur « Les Pionniers » (Eco).

La liste à jour est toujours là : https://www.teamkit.fr/api/v1

1. Les serveurs #

Tous les serveurs en service #

GET /api/v1/serveurs
GET /api/v1/serveurs?jeu=eco

?jeu= garde un seul jeu (le slug du jeu, comme dans teamkit.fr/jeux/eco). La réponse donne nombre et la liste serveurs, chacun avec son slug, son nom, son jeu, son état, ses joueurs, son adresse, ses votes, sa communauté et le lien de sa page.

Un serveur #

GET /api/v1/serveurs/tk-eco-172

{
  "slug": "tk-eco-172",
  "nom": "Les Pionniers",
  "jeu": { "nom": "Eco", "slug": "eco" },
  "etat": "en_ligne",
  "joueurs": 22,
  "places": 40,
  "adresse": "51.254.47.151:3000",
  "lien_connexion": null,
  "carte": "MAP 2.56km²",
  "mode": "communauté",
  "wipe": null,
  "record_joueurs": 49,
  "disponibilite": 100,
  "cpu_pourcent": 12,
  "ram_mo": 9550,
  "votes": { "semaine": 3, "mois": 4, "total": 8 },
  "avis": { "moyenne": 5, "nombre": 1 },
  "prochain_evenement": null,
  "communaute": { "nom": "Les Pionniers", "slug": "les-pionniers-d-eco", "url": "https://www.teamkit.fr/communaute/les-pionniers-d-eco" },
  "liens": {
    "page": "https://www.teamkit.fr/serveur/tk-eco-172",
    "banniere": "https://www.teamkit.fr/banniere/tk-eco-172.png",
    "bandeau": "https://www.teamkit.fr/banniere/tk-eco-172-bandeau.png",
    "mini": "https://www.teamkit.fr/banniere/tk-eco-172-mini.png"
  },
  "mis_a_jour": "2026-10-09T22:55:30+02:00"
}

Champ	Ce que c'est
`adresse`	l'adresse à taper dans le jeu pour rejoindre
`lien_connexion`	un lien qui ouvre le jeu directement (`steam://…`), seulement pour les jeux qui le permettent
`disponibilite`	le pourcentage de temps où le serveur a été en ligne
`cpu_pourcent`, `ram_mo`	ce que le serveur consomme en ce moment (les mêmes chiffres que la page Statut)
`votes.semaine`	remis à zéro chaque lundi
`prochain_evenement`	`{titre, debut, fin, lien}`, ou `null` s'il n'y en a pas
`liens.banniere`, `bandeau`, `mini`	des images à jour toutes seules (600 × 200, 728 × 90, 468 × 60)

L'historique des joueurs #

GET /api/v1/serveurs/tk-eco-172/joueurs?periode=24h

periode vaut 24h (un point par heure), 7j (un point par heure) ou 30j (un point par jour). Chaque point : {"quand": "...", "moyenne": 18.5, "max": 24}. De quoi tracer une courbe.

Les avis publiés #

GET /api/v1/serveurs/tk-eco-172/avis?page=1

20 avis par page, du plus récent au plus ancien : pseudo, note (1 à 5), texte, date. Plus la moyenne et le nombre total.

Les événements à venir #

GET /api/v1/serveurs/tk-eco-172/evenements

Les 5 prochains événements acceptés par le staff : titre, description, debut, fin, lien.

2. Les communautés #

GET /api/v1/communautes/les-pionniers-d-eco

Seulement les communautés vérifiées. La réponse :

Champ	Ce que c'est
`nom`, `description`, `logo`, `banniere`, `discord`, `site`, `tags`	la fiche publique
`membres.declares`	le nombre de membres indiqué par la communauté
`membres.sur_teamkit`	les membres qui ont rejoint la communauté sur teamkit.fr
`recrute`, `entree`, `texte_recrutement`	si elle recrute, et comment entrer : `ouvert`, `candidature` ou `ferme`
`votes.semaine`, `votes.mois`	ses votes
`communaute_du_mois`	`{mois, votes}` si c'est elle en ce moment, sinon `null`
`serveurs`	ses serveurs en service, avec leur état et leurs joueurs

3. Les classements #

GET /api/v1/classements/serveurs?periode=semaine&limite=10
GET /api/v1/classements/serveurs?periode=mois&jeu=minecraft-java
GET /api/v1/classements/communautes?periode=semaine&limite=5
GET /api/v1/classements/communaute-du-mois

periode : semaine (par défaut) ou mois.
limite : de 1 à 25 (10 par défaut).
jeu : seulement pour les serveurs.
À égalité de votes, un serveur avec plus de joueurs passe devant ; pour les communautés, celle qui a le plus de membres.

Chaque ligne : rang, slug, nom, votes, et le lien de la page.

La Communauté du mois renvoie actuelle (ou null avant la première désignation) et historique, les 12 derniers mois.

✔️ Checklist #

J'ai noté les deux ou trois adresses dont j'ai besoin, pas plus.
Je sais quels champs j'affiche, et ce que je montre quand l'un d'eux vaut null.

❓ Si ça ne marche pas #

Tout le monde est à 0 vote : le classement de la semaine repart de zéro chaque lundi. Essaie periode=mois.
Ta communauté répond 404 : elle n'est pas encore vérifiée par le staff.

Une étape qui coince ? Ouvre un ticket sur le site ou demande sur le Discord TeamKit. Le bot Guide connaît ces pages.