Kody odpowiedzi stanu
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
W odpowiedziach HTTP mogą być zwracane te kody stanu.
Kod HTTP |
Opis HTTP |
Uwagi |
2xx |
OK |
Nie jest błędem; zwracany po zakończeniu operacji. Należy go też używać w przypadku błędów logiki biznesowej (np.gdy pole booking_failure w CreateBookingResponse jest wypełnione). |
400 |
Nieprawidłowe żądanie |
Nieprawidłowe żądanie lub nieprawidłowe argumenty (nie znaleziono sprzedawcy, usługi lub przedziału czasu, próba rezerwacji nieprawidłowego przedziału czasu, anulowanie rezerwacji, która nigdy nie istniała). |
401 |
Brak autoryzacji |
Nieautoryzowany (nieprawidłowe dane logowania, spróbuj ponownie zalogować się). Żądanie nie ma prawidłowych danych uwierzytelniających dla tej operacji. |
403 |
Zabroniono |
Odmowa dostępu/zakaz (dzwoniący jest znany i odrzucony). Tego
komunikatu nie należy używać w przypadku odrzuceń spowodowanych wyczerpaniem zasobu (w przypadku takich błędów należy użyć kodu Too Many Requests ).
Nie można używać wartości Forbidden , jeśli nie można zidentyfikować wywołującego (w przypadku takich błędów należy użyć wartości Unauthorized ). |
404 |
Nie znaleziono |
Nie znaleziono (nie znaleziono zasobu, nieprawidłowy URL, w tym nieprawidłowe wywołania RPC) |
409 |
Konflikt |
Operacja została przerwana, najczęściej z powodu problemu równoczesności, np. w przypadku nieudanej kontroli sekwencera lub przerwanej transakcji. |
429 |
Zbyt wiele zgłoszeń |
Niektóre zasoby zostały wyczerpane, np. limit dla poszczególnych użytkowników lub cały system plików nie ma już miejsca. |
499 |
Zamknij żądanie klienta |
Operacja została anulowana, zwykle przez element wywołujący. |
500 |
Wewnętrzny błąd serwera |
Błędy wewnętrzne. Oznacza to, że pewne niezmienniki oczekiwane przez system bazowy zostały uszkodzone. Ten kod błędu jest zarezerwowany dla poważnych błędów. |
501 |
Nie wdrożono |
Operacja nie jest wdrożona lub nie jest obsługiwana/włączona w tej usłudze. |
503 |
Usługa jest niedostępna |
Usługa jest obecnie niedostępna. Jest to najczęściej stan przejściowy, który można rozwiązać, ponawiając próbę z większym odstępem. |
504 |
Przekroczony czas oczekiwania bramy |
Termin upłynął przed wykonaniem operacji. W przypadku operacji, które zmieniają stan systemu, ten błąd może zostać zwrócony nawet wówczas, gdy operacja zakończyła się pomyślnie. Na przykład pomyślna odpowiedź serwera mogła być tak opóźniona, że termin upłynął. |
Czasami może być kilka kodów błędów. Usługi powinny zwracać najbardziej specyficzny kod błędu.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]