Aller au contenu principal

Codes de statut

doitRespecter les codes de statut normalisés par HTTP.

Lecture simple de la classification des codes :

  • 200 à 299 : toute réponse de confirmation positive (opération effectuée, demande enregistrée, …)
  • 400 à 499 : toute réponse indiquant une erreur du client (requête incomplète, mauvais prérequis, ressource introuvable, …)
  • 500 à 599 : toute réponse indiquant une erreur du serveur (service indisponible, erreur interne, …)

Principaux codes utilisés (donc à implémenter) :

  • 200 : ok avec une réponse
  • 201 : ok ressource créée
  • 202 : ok mais traitement effectué de manière asynchrone (plus tard)
  • 204 : ok sans réponse (pas de donnée à renvoyer)
  • 400 : mauvais paramètres dans la requête (query string, ou payload)
  • 401 : non autorisé, une authentification est nécessaire
  • 403 : accès interdit, droits insuffisants
  • 404 : ressource introuvable
  • 405 : mauvaise méthode
  • 409 : conflit, la ressource existe déjà (utilisé lors d'une création)
  • 429 : trop de requêtes (utilisé avec des quotas de limitation d'accès)
  • 500 : erreur interne, ne devrait jamais arriver en situation normale (mauvaise odeur indiquant un déficit de gestion d'erreur)
  • 503 : service indisponible (par exemple en cas d'opération de maintenance)