L’API, sans boîte noire.
Des réponses JSON, en lecture seule et sur la même adresse que le site. Aucun jeton ni compte nécessaire pour ces endpoints publics. Les données privées et l’API de supervision interne ne sont pas exposées.
État et présence
Renvoie state (online, degraded, maintenance ou unavailable), online (nombre de connexions au proxy, ou null si inconnu), version, updatedAt et les états généraux des services. Actualisation du compteur au plus toutes les cinq secondes. Ce n’est pas un historique d’uptime ni une sonde extérieure.
Parties et victoires
[{"name":"PseudoExemple","game":"quake","games":12,"wins":3}]Exemple fictif de format, pas un joueur réel. Une ligne par joueur et mini-jeu ; seules les statistiques autorisées à la publication sont retournées.
Fosse PvP
[{"name":"PseudoExemple","game":"pit","kills":9,"deaths":4}]Exemple fictif. Le choix spécifique de publication PvP s’applique ; l’accord pour les parties et victoires ne suffit pas.
Filtrer les résultats
?name=Aur7 recherche un pseudo exact, sans distinction de casse. &game=quake sélectionne un jeu. &limit=20 limite la réponse, entre 1 et 100 lignes (100 par défaut). Les paramètres peuvent se combiner.
- Jeux :
tntrun,spleef,deacoudre,quake,lucky_race,pit. - Pseudo : lettres, chiffres ou underscore, de 1 à 16 caractères.
- Ordre : victoires puis parties décroissantes ; fosse, éliminations décroissantes puis morts croissantes.
Usage raisonnable
Réponses 200 (y compris liste vide), 400 pour une requête invalide, 429 en cas d’excès de requêtes, 503 si les statistiques sont indisponibles. Ne sondez pas plus d’une fois toutes les 15 secondes ; un plafond technique par adresse et par connexion protège le service.
Les endpoints ne renvoient aucun UUID ou donnée de modération. Ils respectent le retrait de publication à chaque nouvelle lecture et ne doivent pas servir à contourner le choix des joueurs. Aucun accès depuis un autre site via CORS n’est activé.