🚨 Erreurs

Toujours un JSON, avec le bon statut HTTP.

Format

{
  "erreur": {
    "code": "introuvable",
    "message": "Joueur inconnu."
  }
}

Le champ code est stable : utilise-le dans ton programme. Le champ message est destiné à un humain et peut changer.

Statut	Nom	Code	Signification
400	Paramètre invalide	`parametre_invalide`	Un paramètre est mal formé ou hors limites. Le message précise lequel.
404	Introuvable	`introuvable · route_inconnue · joueur_masque`	Le joueur, la guilde, l'annonce ou la route demandée n'existe pas. Un joueur du staff répond aussi 404 (code `joueur_masque`), avec une phrase fun.
405	Méthode interdite	`methode_interdite`	L'API est en lecture seule : seules les méthodes GET, HEAD et OPTIONS sont acceptées.
429	Trop de requêtes	`trop_de_requetes`	Plus de 10 requêtes par seconde depuis ton adresse IP. Attends le délai de l'en-tête Retry-After.
500	Erreur interne	`erreur_interne`	Un incident côté serveur. Réessaie dans un instant.
503	Indisponible	`indisponible`	Le service redémarre ou ne répond plus. Réessaie dans un instant.

Limite de débit

Un 429 vient de la limite de 10 requêtes par seconde. Il porte l'en-tête Retry-After, en secondes.