Codes de réponse de renvoi de l'état
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eHTTP status codes indicate the outcome of a request, ranging from success (2xx) to various error types.\u003c/p\u003e\n"],["\u003cp\u003eClient errors (4xx) signal issues with the request itself, such as invalid credentials (401) or missing resources (404).\u003c/p\u003e\n"],["\u003cp\u003eServer errors (5xx) indicate problems on the server side, including internal errors (500) or service unavailability (503).\u003c/p\u003e\n"],["\u003cp\u003eWhen multiple error codes apply, the most specific one should be used.\u003c/p\u003e\n"],["\u003cp\u003eBusiness logic failures, despite not being technical errors, should utilize a 2xx status code with further details provided in the response body.\u003c/p\u003e\n"]]],["HTTP responses can include various status codes: 2xx signifies success, used even for business logic failures. 400 indicates bad requests, 401 for unauthorized access, and 403 for forbidden actions. 404 means resource not found, 409 a conflict, and 429 too many requests. 499 denotes client-canceled operation, 500 internal errors, 501 unimplemented features, 503 service unavailability, and 504 gateway timeout. The most specific error code should be used when multiple codes apply.\n"],null,["# Status Response Codes\n\nThe following status codes can be returned in HTTP responses.\n\n| HTTP Code | HTTP Description | Notes |\n|-----------|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 2xx | OK | Not an error; returned on success. This should also be used for business logic failures (e.g. `booking_failure` in [`CreateBookingResponse`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-methods/createbooking-method) is populated) |\n| 400 | Bad Request | Bad Request/Invalid Arguments (merchant, service, slot not found, trying to book an invalid slot, cancelling a booking that never existed). |\n| 401 | Unauthorized | Unauthenticated (invalid credentials, retry login). The request does not have valid authentication credentials for the operation. |\n| 403 | Forbidden | Permission denied/forbidden (caller is known and rejected). This response must not be used for rejections caused by exhausting some resource (use `Too Many Requests` instead for those errors). `Forbidden` must not be used if the caller can not be identified (use `Unauthorized` instead for those errors). |\n| 404 | Not Found | Not found (Resource not found, invalid url, including invalid RPCs) |\n| 409 | Conflict | The operation was aborted, typically due to a concurrency issue such as a sequencer check failure or transaction abort. |\n| 429 | Too Many Requests | Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space. |\n| 499 | Client Closed Request | The operation was cancelled, typically by the caller. |\n| 500 | Internal Server Error | Internal errors. This means that some invariants expected by the underlying system have been broken. This error code is reserved for serious errors. |\n| 501 | Not Implemented | The operation is not implemented or is not supported/enabled in this service. |\n| 503 | Service Unavailable | The service is currently unavailable. This is most likely a transient condition, which can be corrected by retrying with a backoff. |\n| 504 | Gateway Timeout | The deadline expired before the operation could complete. For operations that change the state of the system, this error may be returned even if the operation has completed successfully. For example, a successful response from a server could have been delayed long enough for the deadline to expire. |\n\nSometimes multiple error codes may apply. Services should return the most\nspecific error code that applies."]]
