Developer
HTTP 상태 코드 — 완전한 참조 가이드
클래스별(1xx-5xx)로 정리된 HTTP 상태 코드 전체 목록입니다. 각 코드의 의미, 일반적인 사용 사례, 발생 상황을 설명합니다.
1xx 정보
이 코드들은 요청이 수신되었고 서버가 처리를 계속하고 있음을 나타냅니다.
| 코드 | 이름 | 설명 |
|---|---|---|
| 100 | Continue | 서버가 요청 헤더를 수신했으며 클라이언트가 요청 본문을 보내야 합니다. |
| 101 | Switching Protocols | 서버가 클라이언트 요청에 따라 프로토콜을 전환하고 있습니다 (예: WebSocket 업그레이드). |
| 102 | Processing | 서버가 요청을 처리 중이지만 아직 완료되지 않았습니다 (WebDAV). |
| 103 | Early Hints | 최종 HTTP 메시지 전에 일부 응답 헤더를 반환하는 데 사용됩니다. |
2xx 성공
이 코드들은 요청이 성공적으로 수신, 이해, 수락되었음을 나타냅니다.
| 코드 | 이름 | 설명 |
|---|---|---|
| 200 | OK | 요청이 성공했습니다. 의미는 사용된 HTTP 메서드에 따라 다릅니다. |
| 201 | Created | 요청이 성공하고 새 리소스가 생성되었습니다. POST 요청 후 일반적입니다. |
| 202 | Accepted | 요청이 처리를 위해 수락되었지만 아직 완료되지 않았습니다. |
| 203 | Non-Authoritative Information | 반환된 메타데이터가 원본 서버가 아닌 로컬 또는 서드파티 복사본입니다. |
| 204 | No Content | 요청이 성공했지만 반환할 콘텐츠가 없습니다. DELETE 요청에서 일반적입니다. |
| 205 | Reset Content | 서버가 요청을 이행했고 클라이언트에게 문서 뷰를 재설정하도록 요청합니다. |
| 206 | Partial Content | 클라이언트가 보낸 Range 헤더로 인해 서버가 리소스의 일부만 전송하고 있습니다. |
| 207 | Multi-Status | 여러 하위 요청에 대한 다중 상태 코드입니다 (WebDAV). |
| 208 | Already Reported | DAV 바인딩의 멤버가 이미 열거되었습니다 (WebDAV). |
| 226 | IM Used | 서버가 인스턴스 조작을 적용하여 리소스에 대한 GET 요청을 이행했습니다. |
3xx 리디렉션
이 코드들은 요청을 완료하기 위해 추가 작업이 필요함을 나타내며, 일반적으로 리디렉션입니다.
| 코드 | 이름 | 설명 |
|---|---|---|
| 300 | Multiple Choices | 리소스에 대한 여러 옵션이 있습니다. 클라이언트가 하나를 선택할 수 있습니다. |
| 301 | Moved Permanently | 리소스가 새 URL로 영구적으로 이동했습니다. 검색 엔진이 인덱스를 업데이트합니다. |
| 302 | Found | 리소스가 임시적으로 다른 URL에 있습니다. 클라이언트는 원래 URL을 계속 사용해야 합니다. |
| 303 | See Other | 요청에 대한 응답을 GET 메서드를 사용하여 다른 URL에서 찾을 수 있습니다. |
| 304 | Not Modified | 마지막 요청 이후 리소스가 수정되지 않았습니다. 캐싱에 사용됩니다. |
| 305 | Use Proxy | 요청된 리소스는 Location 헤더에 지정된 프록시를 통해 접근해야 합니다 (사용 중단). |
| 307 | Temporary Redirect | 리소스가 임시적으로 다른 URL에 있습니다. 새 요청에도 동일한 메서드를 사용해야 합니다. |
| 308 | Permanent Redirect | 리소스가 영구적으로 이동했습니다. 새 요청에도 동일한 메서드를 사용해야 합니다. |
4xx 클라이언트 오류
이 코드들은 클라이언트가 요청에서 오류를 발생시킨 것으로 보이는 경우를 나타냅니다.
| 코드 | 이름 | 설명 |
|---|---|---|
| 400 | Bad Request | 잘못된 문법이나 잘못된 매개변수로 인해 서버가 요청을 처리할 수 없습니다. |
| 401 | Unauthorized | 인증이 필요합니다. 클라이언트가 유효한 자격 증명을 제공해야 합니다. |
| 402 | Payment Required | 향후 사용을 위해 예약됨. 때때로 디지털 결제 시스템에 사용됩니다. |
| 403 | Forbidden | 서버가 요청을 이해했지만 승인을 거부합니다. 인증으로도 해결되지 않습니다. |
| 404 | Not Found | 서버가 요청한 리소스를 찾을 수 없습니다. 웹에서 가장 흔한 오류입니다. |
| 405 | Method Not Allowed | 사용된 HTTP 메서드가 요청한 리소스에서 지원되지 않습니다. |
| 406 | Not Acceptable | 서버가 클라이언트가 보낸 Accept 헤더와 일치하는 응답을 생성할 수 없습니다. |
| 407 | Proxy Authentication Required | 클라이언트가 먼저 프록시에 인증해야 합니다. |
| 408 | Request Timeout | 서버가 클라이언트의 요청을 기다리다 시간 초과되었습니다. |
| 409 | Conflict | 요청이 서버의 현재 상태와 충돌합니다 (예: 중복 리소스). |
| 410 | Gone | 리소스가 이전에 존재했지만 영구적으로 제거되었습니다. |
| 411 | Length Required | 요청에 필요한 콘텐츠 길이가 지정되지 않았습니다. |
| 412 | Precondition Failed | 요청 헤더 필드의 하나 이상의 조건이 false로 평가되었습니다. |
| 413 | Payload Too Large | 요청 엔티티가 서버가 처리할 수 있는 크기보다 큽니다. |
| 414 | URI Too Long | 제공된 URI가 서버가 처리하기에 너무 깁니다. |
| 415 | Unsupported Media Type | 요청된 데이터의 미디어 형식이 서버에서 지원되지 않습니다. |
| 416 | Range Not Satisfiable | Range 헤더로 지정된 범위를 충족할 수 없습니다. |
| 417 | Expectation Failed | 서버가 Expect 요청 헤더 필드의 요구 사항을 충족할 수 없습니다. |
| 418 | I'm a Teapot | 서버가 커피를 내리기를 거부합니다. 서버는 영구적으로 찻주전자이기 때문입니다 (만우절 RFC 2324). |
| 421 | Misdirected Request | 요청이 응답을 생성할 수 없는 서버로 전달되었습니다. |
| 422 | Unprocessable Entity | 요청 형식은 올바르지만 서버가 포함된 명령을 처리할 수 없었습니다. |
| 423 | Locked | 접근하려는 리소스가 잠겨 있습니다 (WebDAV). |
| 424 | Failed Dependency | 다른 요청의 실패로 인해 요청이 실패했습니다 (WebDAV). |
| 425 | Too Early | 서버가 재생될 수 있는 요청을 처리하지 않습니다. |
| 426 | Upgrade Required | 클라이언트가 다른 프로토콜로 전환해야 합니다. |
| 428 | Precondition Required | 원본 서버가 요청을 조건부로 요구합니다. |
| 429 | Too Many Requests | 사용자가 주어진 시간 내에 너무 많은 요청을 보냈습니다 (속도 제한). |
| 431 | Request Header Fields Too Large | 헤더가 너무 커서 서버가 요청 처리를 거부합니다. |
| 451 | Unavailable For Legal Reasons | 법적 요구에 의해 서버가 리소스 접근을 거부합니다. |
5xx 서버 오류
이 코드들은 서버가 유효한 요청을 이행하는 데 실패했음을 나타냅니다.
| 코드 | 이름 | 설명 |
|---|---|---|
| 500 | Internal Server Error | 서버가 예상치 못한 상황을 만났을 때의 일반적인 오류 메시지입니다. |
| 501 | Not Implemented | 서버가 요청을 이행하는 데 필요한 기능을 지원하지 않습니다. |
| 502 | Bad Gateway | 서버가 게이트웨이 또는 프록시 역할로 작동하면서 상위 서버로부터 잘못된 응답을 받았습니다. |
| 503 | Service Unavailable | 서버가 요청을 처리할 준비가 되지 않았습니다. 유지보수 또는 과부하 시 일반적입니다. |
| 504 | Gateway Timeout | 서버가 게이트웨이 또는 프록시 역할로 작동하면서 시기적절한 응답을 받지 못했습니다. |
| 505 | HTTP Version Not Supported | 서버가 요청에 사용된 HTTP 프로토콜 버전을 지원하지 않습니다. |
| 506 | Variant Also Negotiates | 투명한 콘텐츠 협상이 순환 참조를 만들었습니다. |
| 507 | Insufficient Storage | 서버가 요청을 완료하는 데 필요한 표현을 저장할 수 없습니다 (WebDAV). |
| 508 | Loop Detected | 서버가 요청을 처리하는 동안 무한 루프를 감지했습니다 (WebDAV). |
| 510 | Not Extended | 서버가 요청을 이행하려면 요청에 대한 추가 확장이 필요합니다. |
| 511 | Network Authentication Required | 클라이언트가 네트워크 접근을 얻으려면 인증이 필요합니다 (캡티브 포털). |