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.