Mã phản hồi trạng thái
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Các mã trạng thái sau đây có thể được trả về trong phản hồi HTTP.
| Mã HTTP |
Nội dung mô tả HTTP |
Ghi chú |
| 2xx |
OK |
Không phải lỗi; được trả về khi thành công. Bạn cũng nên sử dụng phương thức này cho các lỗi logic nghiệp vụ (ví dụ: booking_failure trong CreateBookingResponse được điền sẵn) |
| 400 |
Yêu cầu lỗi |
Yêu cầu không hợp lệ/Đối số không hợp lệ (không tìm thấy người bán, dịch vụ, khung giờ, đang cố gắng đặt khung giờ không hợp lệ, huỷ một lượt đặt chỗ chưa từng tồn tại). |
| 401 |
Không được cho phép |
Chưa xác thực (thông tin xác thực không hợp lệ, hãy thử đăng nhập lại). Yêu cầu không có thông tin xác thực hợp lệ cho thao tác. |
| 403 |
Cấm |
Quyền bị từ chối/bị cấm (phương thức gọi được xác định và bị từ chối). Bạn không được sử dụng phản hồi này cho các trường hợp từ chối do sử dụng hết một số tài nguyên (hãy sử dụng Too Many Requests cho các lỗi đó).
Không được sử dụng Forbidden nếu không xác định được phương thức gọi (hãy sử dụng Unauthorized cho các lỗi đó). |
| 404 |
Không Tìm thấy |
Không tìm thấy (Không tìm thấy tài nguyên, URL không hợp lệ, bao gồm cả RPC không hợp lệ) |
| 409 |
Tình huống xung đột |
Thao tác đã bị huỷ, thường là do vấn đề đồng thời, chẳng hạn như lỗi kiểm tra trình tự hoặc huỷ giao dịch. |
| 429 |
Quá nhiều yêu cầu |
Một số tài nguyên đã hết, có thể là hạn mức trên mỗi người dùng hoặc có thể toàn bộ hệ thống tệp đã hết dung lượng. |
| 499 |
Yêu cầu đã đóng của ứng dụng |
Thao tác đã bị huỷ, thường là do phương thức gọi. |
| 500 |
Lỗi máy chủ nội bộ |
Lỗi nội bộ. Điều này có nghĩa là một số hằng số không đổi mà hệ thống cơ bản dự kiến đã bị phá vỡ. Mã lỗi này được dành riêng cho các lỗi nghiêm trọng. |
| 501 |
Chưa triển khai |
Thao tác này không được triển khai hoặc không được hỗ trợ/bật trong dịch vụ này. |
| 503 |
Dịch vụ không khả dụng |
Dịch vụ này hiện không dùng được. Đây có thể là một điều kiện tạm thời, có thể được khắc phục bằng cách thử lại với thời gian đợi. |
| 504 |
Hết thời gian chờ của cổng |
Thời hạn đã hết trước khi thao tác có thể hoàn tất. Đối với các thao tác thay đổi trạng thái của hệ thống, lỗi này có thể được trả về ngay cả khi thao tác đã hoàn tất thành công. Ví dụ: phản hồi thành công từ máy chủ có thể bị trì hoãn đủ lâu để thời hạn hết hạn. |
Đôi khi, có thể áp dụng nhiều mã lỗi. Dịch vụ phải trả về mã lỗi cụ thể nhất có thể áp dụng.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
