Diagnostic

Réponses d’erreur API

Les erreurs HTTP retournées par l’API doivent permettre au client de diagnostiquer rapidement un problème d’authentification, de validation, de droits ou de volumétrie.

Table de référence

Code	Signification	Cas typique
`400`	Bad Request	Paramètres invalides ou mal formés
`401`	Unauthorized	Clé API absente ou invalide
`403`	Forbidden	Accès interdit à la ressource
`404`	Not Found	Ressource inexistante
`422`	Unprocessable Entity	Erreur de validation métier
`429`	Too Many Requests	Limite de débit ou quota dépassé
`500`	Internal Server Error	Erreur serveur non prévue

Erreur de validation

{
  "message": "The given data was invalid.",
  "errors": {
    "lat": [
      "The lat field is required."
    ]
  }
}

Erreur serveur

{
  "message": "Server Error"
}

En production, évite d’exposer les détails internes de stack, SQL ou traces applicatives dans les réponses publiques.