Codes d'état HTTP

Les codes d'état ci-dessous peuvent être renvoyés dans les réponses HTTP.

Code HTTP Description HTTP Remarques
2xx OK Pas une erreur, affiché en cas de réussite. Cette valeur doit également être utilisée pour les échecs de logique métier (par exemple, booking_failure dans CreateBookingResponse est renseigné).
400 Requête incorrecte Requête erronée/arguments incorrects (marchand, service ou créneau introuvable, tentative de réservation d'un créneau non valide, annulation d'une réservation qui n'a jamais existé)
401 Non autorisé Non authentifié (identifiants non valides, nouvelle tentative de connexion recommandée). La requête ne dispose pas d'identifiants d'authentification valides pour l'opération.
403 Interdit Autorisation refusée/interdite (l'appelant est connu et refusé). Cette réponse ne doit pas être utilisée pour les refus dus à l'épuisement d'une ressource (utilisez plutôt Too Many Requests dans ce cas). Forbidden ne doit pas être utilisé si l'appelant ne peut pas être identifié (utilisez plutôt Unauthorized pour ces erreurs).
404 Introuvable Introuvable (ressource introuvable, URL incorrecte, y compris appels RPC incorrects)
409 Élément perturbateur L'opération a été abandonnée, généralement en raison d'un problème de simultanéité, tel qu'un échec de vérification du séquenceur ou un abandon de transaction.
429 Trop de demandes Certaines ressources ont été épuisées ; par exemple, un quota par utilisateur a été atteint ou le système de fichiers dans son intégralité manque d'espace.
499 Le client a fermé la requête L'opération a été annulée, généralement par l'appelant.
500 Erreur interne du serveur Erreurs internes. Cela signifie que certains invariants attendus par le système sous-jacent n'ont pas été respectés. Ce code d'erreur est réservé aux erreurs graves.
501 Non mise en oeuvre L'opération n'est pas implémentée ou n'est pas prise en charge/activée dans ce service.
503 Service indisponible Le service est actuellement indisponible. Il s'agit probablement d'une condition temporaire qui peut être corrigée en réessayant après avoir laissé passer un intervalle entre les tentatives.
504 Expiration du délai de la passerelle Le délai a expiré avant que l'opération puisse se terminer. Pour les opérations qui modifient l'état du système, cette erreur peut être affichée même si l'opération s'est terminée avec succès. Par exemple, une réponse réussie d'un serveur a été retardée suffisamment longtemps pour que le délai expire.

Parfois, plusieurs codes d'erreur peuvent s'appliquer. Les services doivent renvoyer le code d'erreur le plus spécifique qui s'applique.