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)