Les codes d'état ci-dessous peuvent être renvoyés dans les réponses HTTP.
| Code HTTP | Description HTTP | Remarques |
|---|---|---|
| 2xx | OK | Il ne s'agit pas d'une erreur. Ce code est affiché en cas de réussite. Ce champ doit également être utilisé pour les échecs de logique métier (par exemple, booking_failure dans CreateBookingResponse est renseigné). |
| 400 | Requête incorrecte | Requête incorrecte/Arguments non valides (marchand, service, 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 causés par l'épuisement d'une ressource (utilisez plutôt Too Many Requests pour ces erreurs).
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 | Conflit | L'opération a été annulé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 requêtes | Certaines ressources sont épuisées (un quota par utilisateur ou peut-être, par exemple). L'espace disponible dans tout le système de fichiers est peut-être insuffisant. |
| 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 certaines invariants attendus par le système sous-jacent ont été endommagées. Ce code d'erreur est réservé aux erreurs graves. |
| 501 | Non mise en œuvre | L'opération n'est pas mise en œuvre ou n'est pas compatible/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 renvoyée même si l'opération s'est terminée avec succès. Par exemple, une réponse réussie d'un serveur peut avoir é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.