📐 Conventions

Les règles communes à toutes les routes de l'API.

Adresse de base

https://api.nalyora.fr/v1. Toutes les routes sont en GET. Les méthodes HEAD et OPTIONS sont acceptées, les autres reçoivent une erreur 405.

Aucune clé

L'API est publique : pas de clé, pas de compte. Ne t'authentifie nulle part et n'envoie aucune donnée personnelle.

Limite de débit

10 requêtes par seconde et par adresse IP, avec un court surplus toléré (10 requêtes). Au-delà, la réponse est 429 avec l'en-tête Retry-After.

Pagination

Les listes acceptent limite (1 à 100, 20 par défaut) et decalage (nombre de résultats à sauter). La réponse contient total, le nombre de résultats avant pagination.

Joueurs et guildes

Un joueur se désigne par son pseudo (lettres, chiffres et _, 16 caractères au plus) ou son UUID. Une guilde se désigne par son identifiant numérique ou par son nom sans mise en forme.

Dates et nombres

Les dates sont au format ISO 8601, en UTC (2026-11-05T02:24:13Z). Les sommes d'argent sont des nombres décimaux à deux décimales au plus.

CORS et cache

Les requêtes depuis un navigateur sont acceptées de n'importe quelle origine. Chaque réponse porte un en-tête Cache-Control avec la durée pendant laquelle tu peux la réutiliser.

Joueurs masqués

Les membres du staff n'apparaissent dans aucun classement. Si tu cherches leur profil, l'API répond 404 avec le code joueur_masque et une phrase fun : à toi de l'afficher avec le sourire.

Données exposées