Les codes d'état ci-dessous peuvent être renvoyés dans les réponses HTTP.
Code HTTP | Description HTTP | Notes |
---|---|---|
2xx | OK | Il ne s'agit pas d'une erreur. Ce code est affiché en cas de réussite. Cette valeur doit également être utilisée en cas d'échec 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 | Élément perturbateur | 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. Il peut s'agir d'un quota par utilisateur ou de tout le système de fichiers à court 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 certaines règles invariantes attendues par le système sous-jacent ont été rompues. Ce code d'erreur est réservé aux erreurs graves. |
501 | Non mise en oeuvre | 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 très probablement d'une condition temporaire, qui peut être corrigée en réessayant après avoir laissé 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 a abouti. Par exemple, une réponse réussie d'un serveur a pu être 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.