상태 응답 코드
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
다음 상태 코드가 HTTP 응답에서 반환될 수 있습니다.
| HTTP 코드 |
HTTP 설명 |
참고 |
| 2xx |
정상 |
오류 아님, 성공 시 반환 비즈니스 로직 실패에도 사용해야 합니다(예: CreateBookingResponse의 booking_failure가 채워짐). |
| 400 |
잘못된 요청 |
잘못된 요청 또는 잘못된 인수입니다 (판매자, 서비스, 시간대를 찾을 수 없음, 잘못된 시간대에 예약 시도, 존재하지 않는 예약 취소). |
| 401 |
승인되지 않음 |
인증이 완료되지 않았습니다(잘못된 사용자 인증 정보, 로그인 다시 시도). 요청에 작업과 관련된 올바른 사용자 인증 정보가 없습니다. |
| 403 |
금지됨 |
권한이 거부 또는 금지되었습니다(호출자가 알려져 있고 거부됨). 일부 리소스가 소진되어 거부된 경우에는 이 응답을 사용해서는 안 됩니다. 대신 이러한 오류에는 Too Many Requests 코드를 사용히세요.
호출자를 식별할 수 없는 경우에는 Forbidden가 아닌 Unauthorized를 사용해야 합니다. |
| 404 |
찾을 수 없음 |
요청한 항목을 찾을 수 없습니다(잘못된 RPC 포함, 잘못된 URL, 리소스를 찾을 수 없음). |
| 409 |
충돌 |
작업이 취소되었습니다. 대개 시퀀서 확인 실패, 트랜잭션 취소 등의 동시 실행 문제가 원인입니다. |
| 429 |
요청한 횟수가 너무 많음 |
일부 리소스가 소진되었습니다. 사용자당 할당량이나 전체 파일 시스템의 저장용량이 부족하기 때문일 수 있습니다. |
| 499 |
고객이 요청을 종료함 |
작업이 취소되었습니다. 대개 호출자에 의해 취소됩니다. |
| 500 |
내부 서버 오류 |
내부 오류가 발생했습니다. 이는 기본 시스템에서 예상하는 불변 항목에 문제가 있는 경우입니다. 이 오류 코드는 심각한 오류를 위해 예약되어 있습니다. |
| 501 |
구현되지 않음 |
작업이 구현되지 않았거나 이 서비스에서 지원되지 않거나 사용 설정되지 않았습니다. |
| 503 |
서비스를 사용할 수 없음 |
현재 서비스를 사용할 수 없습니다. 일시적인 상태일 가능성이 높으며, 잠시 시간을 두고 다시 시도하면 해결될 수 있습니다. |
| 504 |
게이트웨이 시간 초과 |
작업을 완료하기 전에 기한이 지났습니다. 시스템의 상태를 변경하는 작업의 경우 작업이 정상적으로 완료되어도 이 오류가 반환될 수 있습니다. 예를 들어 서버의 성공 응답이 오래 지연되어 기한이 지났을 수 있습니다. |
여러 오류 코드가 적용될 수 있는 경우도 있습니다. 서비스는 적용되는 오류 코드 중 가장 구체적인 코드를 반환해야 합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 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."]]
