HTTP 상태 코드
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP POST 또는 HTTP GET 요청에 대한 응답으로 서버에서 생성할 수 있는 HTTP 상태 코드입니다.
200 OK: 요청이 성공했습니다.400 Bad Request: 잘못된 인수입니다(잘못된 요청 페이로드).403 Forbidden: 권한이 거부되었습니다(예: 잘못된 API 키).429 Resource Exhausted: 리소스 할당량이 부족하거나 비율 한도에 도달하였습니다.500 Internal Server Error: 내부 서버 오류가 발생했습니다(요청 다시 시도).503 Service Unavailable 사용 불가504 Gateway Timeout: 기한이 지났습니다(요청 다시 시도).
참고: 실패한 HTTP 응답을 수신하는 클라이언트 (즉, 200 OK 이외의 HTTP 상태 코드)는 백오프 모드로 전환되어야 합니다.
HTTP 상태 코드 400 Bad Request를 수신하는 이뉴는 다음과 같습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThe server generates HTTP status codes like \u003ccode\u003e200 OK\u003c/code\u003e for success and various error codes (\u003ccode\u003e400\u003c/code\u003e, \u003ccode\u003e403\u003c/code\u003e, \u003ccode\u003e429\u003c/code\u003e, \u003ccode\u003e500\u003c/code\u003e, \u003ccode\u003e503\u003c/code\u003e, \u003ccode\u003e504\u003c/code\u003e) for different issues encountered during \u003ccode\u003ePOST\u003c/code\u003e or \u003ccode\u003eGET\u003c/code\u003e requests.\u003c/p\u003e\n"],["\u003cp\u003eClients receiving unsuccessful HTTP responses (any code other than \u003ccode\u003e200 OK\u003c/code\u003e) should enter back-off mode to avoid overwhelming the server.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003e400 Bad Request\u003c/code\u003e errors can arise from invalid arguments in requests to \u003ccode\u003efullHashes.find\u003c/code\u003e, \u003ccode\u003ethreatListUpdates.fetch\u003c/code\u003e, or \u003ccode\u003ethreatMatches.find\u003c/code\u003e methods, such as invalid hashes, empty update requests, or missing threat entry types.\u003c/p\u003e\n"]]],["The server responds to HTTP `POST` or `GET` requests with various status codes. `200 OK` indicates success. Errors include `400 Bad Request` for invalid input, `403 Forbidden` for permission issues, `429 Resource Exhausted` for quota/rate limits, `500` for internal errors, `503` for unavailability, and `504` for timeouts. A non-`200 OK` response requires clients to enter back-off mode. `400` errors may occur due to invalid hashes, empty update requests, or missing threat information.\n"],null,["# HTTP Status Codes\n\nHTTP status codes the server can generate in response to an HTTP `POST` or\nHTTP `GET` request:\n\n- `200 OK`: Successful request.\n- `400 Bad Request`: Invalid argument (invalid request payload).\n- `403 Forbidden`: Permission denied (e.g. invalid API key).\n- `429 Resource Exhausted`: Either out of resource quota or reaching rate limiting.\n- `500 Internal Server Error`: Internal server error (retry your request).\n- `503 Service Unavailable`: Unavailable.\n- `504 Gateway Timeout`: Deadline exceeded (retry your request).\n\n**Note** : Clients that receive an unsuccessful HTTP response (that is, any HTTP\nstatus code other than `200 OK`) must enter\n[back-off mode](/safe-browsing/v4/request-frequency#back-off-mode).\n\n\nPossible reasons for receiving HTTP status code `400 Bad Request`:\n\n- [fullHashes.find](/safe-browsing/reference/rest/v4/fullHashes/find): Invalid hash.\n- [threatListUpdates.fetch](/safe-browsing/reference/rest/v4/threatListUpdates/fetch): Empty update request, or invalid list configuration, or list does not exist for the requested configuration.\n- [threatMatches.find](/safe-browsing/reference/rest/v4/threatMatches/find): Threat entry type not set in threat info section of request."]]
