HTTP 상태 코드 참조표
HTTP 상태 코드가 무슨 의미인지 찾아봅니다.
| 100 | Continue | 요청의 초기 부분이 수신되었으며, 클라이언트는 나머지 요청을 계속 보내야 합니다. |
| 101 | Switching Protocols | 서버가 클라이언트의 요청에 따라 프로토콜을 전환합니다. 예: WebSocket으로 업그레이드. |
| 102 | Processing | 서버가 전체 요청을 받았지만 아직 처리를 완료하지 않았습니다(WebDAV). |
| 103 | Early Hints | 서버가 최종 응답을 준비하는 동안 클라이언트가 미리 리소스를 로드하기 시작할 수 있게 합니다. |
| 200 | OK | 요청이 성공했으며, 응답 본문에 요청한 리소스가 담겨 있습니다. |
| 201 | Created | 요청이 성공했고 그 결과로 새 리소스가 생성되었습니다. |
| 202 | Accepted | 요청이 처리를 위해 수락되었지만, 처리가 아직 완료되지는 않았습니다. |
| 203 | Non-Authoritative Information | 반환된 메타데이터는 원본 서버가 아니라 제3자나 로컬 캐시의 사본에서 온 것입니다. |
| 204 | No Content | 요청은 성공했지만 반환할 내용이 없습니다. |
| 205 | Reset Content | 요청은 성공했습니다. 클라이언트는 요청을 보낸 문서 화면을 초기화해야 합니다. |
| 206 | Partial Content | 바이트 범위 요청에 맞춰 리소스의 일부만 전달되고 있습니다. |
| 207 | Multi-Status | 여러 상태 코드가 적절할 수 있는 상황에서 여러 리소스에 대한 정보를 전달합니다(WebDAV). |
| 208 | Already Reported | WebDAV 바인딩의 구성원이 응답의 이전 부분에서 이미 나열되었습니다. |
| 226 | IM Used | 서버가 하나 이상의 인스턴스 조작을 사용해 요청을 처리했습니다. |
| 300 | Multiple Choices | 요청에 대해 가능한 응답이 여러 개이며, 클라이언트가 그중 하나를 선택해야 합니다. |
| 301 | Moved Permanently | 리소스가 응답에 제시된 새 URL로 영구적으로 이동되었습니다. |
| 302 | Found | 리소스가 일시적으로 다른 URL에 있습니다. 이후 요청에도 원래 URL을 계속 사용해야 합니다. |
| 303 | See Other | 응답은 GET 요청을 사용해 다른 URL에서 찾을 수 있습니다. |
| 304 | Not Modified | 리소스가 클라이언트의 캐시 헤더에 명시된 버전 이후로 변경되지 않았습니다. |
| 307 | Temporary Redirect | 리소스가 일시적으로 다른 URL에 있습니다. 302와 달리 원래의 요청 메서드를 그대로 사용해야 합니다. |
| 308 | Permanent Redirect | 리소스가 새 URL로 영구적으로 이동되었습니다. 원래의 요청 메서드를 그대로 사용해야 합니다. |
| 400 | Bad Request | 구문이 잘못되어 서버가 요청을 이해할 수 없었습니다. |
| 401 | Unauthorized | 인증이 필요하지만, 인증에 실패했거나 제공되지 않았습니다. |
| 402 | Payment Required | 향후 사용을 위해 예약된 상태 코드로, 원래는 디지털 결제 시스템을 위해 고안되었습니다. |
| 403 | Forbidden | 요청은 이해되었지만, 클라이언트에게 해당 콘텐츠에 대한 접근 권한이 없습니다. |
| 404 | Not Found | 서버가 요청한 리소스를 찾을 수 없습니다. |
| 405 | Method Not Allowed | 요청 메서드는 알려져 있지만 대상 리소스에서 지원하지 않습니다. |
| 406 | Not Acceptable | 서버가 클라이언트의 Accept 헤더에 맞는 응답을 생성할 수 없습니다. |
| 407 | Proxy Authentication Required | 요청을 계속 진행하려면 먼저 프록시에 대한 인증이 필요합니다. |
| 408 | Request Timeout | 서버가 클라이언트의 요청을 기다리다가 시간이 초과되었습니다. |
| 409 | Conflict | 요청이 대상 리소스의 현재 상태와 충돌합니다. |
| 410 | Gone | 요청한 리소스는 더 이상 사용할 수 없으며 영구적으로 삭제되었습니다. |
| 411 | Length Required | 서버는 Content-Length 헤더를 요구하지만, 요청에 이 헤더가 없었습니다. |
| 412 | Precondition Failed | 요청 헤더에 명시된 전제 조건을 서버가 충족하지 못했습니다. |
| 413 | Payload Too Large | 요청 본문이 서버가 처리할 수 있거나 처리하려는 크기보다 큽니다. |
| 414 | URI Too Long | 요청한 URI가 서버가 해석하려는 길이보다 깁니다. |
| 415 | Unsupported Media Type | 요청의 미디어 형식을 서버가 지원하지 않습니다. |
| 416 | Range Not Satisfiable | 리소스 크기를 고려할 때 요청한 바이트 범위를 충족할 수 없습니다. |
| 417 | Expectation Failed | 서버가 요청의 Expect 헤더에 명시된 기대 사항을 충족할 수 없습니다. |
| 418 | I'm a Teapot | RFC 2324에서 만우절 농담으로 정의된 장난스러운 상태 코드입니다. 서버는 커피를 내려서는 안 됩니다. |
| 421 | Misdirected Request | 대상 URI에 대한 응답을 생성할 수 없는 서버로 요청이 전송되었습니다. |
| 422 | Unprocessable Content | 요청 형식은 올바르지만, 처리를 가로막는 의미상의 오류가 포함되어 있습니다. |
| 423 | Locked | 접근하려는 리소스가 잠겨 있습니다(WebDAV). |
| 424 | Failed Dependency | 요청이 실패한 다른 요청에 의존했기 때문에 실패했습니다(WebDAV). |
| 425 | Too Early | 서버가 재전송(리플레이)될 수 있는 요청의 처리를 거부합니다. |
| 426 | Upgrade Required | 클라이언트는 Upgrade 헤더에 명시된 다른 프로토콜로 전환해야 합니다. |
| 428 | Precondition Required | 원본 서버는 요청이 조건부여야 한다고 요구합니다. |
| 429 | Too Many Requests | 클라이언트가 일정 시간 동안 너무 많은 요청을 보냈습니다(속도 제한). |
| 431 | Request Header Fields Too Large | 요청의 헤더 필드가 너무 커서 서버가 요청을 처리하지 않습니다. |
| 451 | Unavailable For Legal Reasons | 정부가 요구한 검열 등 법적인 이유로 리소스를 이용할 수 없습니다. |
| 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 | 요청을 완료하는 데 필요한 표현(representation)을 서버가 저장할 수 없습니다(WebDAV). |
| 508 | Loop Detected | 서버가 요청을 처리하는 중 무한 루프를 감지했습니다(WebDAV). |
| 510 | Not Extended | 서버가 요청을 처리하려면 추가적인 확장이 필요합니다. |
| 511 | Network Authentication Required | 네트워크에 접속하려면 클라이언트가 인증해야 합니다. 보통 캡티브 포털에서 나타납니다. |
사용 예시
API 응답의 상태 코드 의미 파악하기
백엔드 API가 돌려준 422 같은 낯선 코드를 검색해서, 어떤 의미이고 어떻게 대응해야 하는지 빠르게 확인하세요.
리다이렉션 코드 올바르게 고르기
301과 308, 302와 307의 차이를 확인해서 URL을 옮길 때 어떤 리다이렉션 코드를 써야 할지 결정하세요.
브라우저 네트워크 탭에서 본 코드 찾아보기
브라우저 개발자 도구의 네트워크 탭에서 본 상태 코드를 검색해서, 요청이 왜 실패했는지 이해하세요.
인증 디버깅 중 401과 403 구분하기
'401'과 '403'을 나란히 검색해서 정확한 차이를 확인하세요. 401은 요청에 유효한 자격 증명이 없다는 뜻이고, 403은 자격 증명은 유효하지만 사용자가 해당 리소스에 접근할 권한이 없다는 뜻입니다.
클라이언트에서 요청 제한(rate limiting) 처리 방법 정하기
429를 검색해서 요청이 너무 많다는 뜻임을 확인하고, 재시도하기 전에 API 응답에 존중해야 할 Retry-After 헤더가 포함되어 있는지 확인하세요.
자주 묻는 질문
이 목록에 있는 코드가 실제로 전부 표준인가요?
네 — 모두 IANA의 공식 HTTP 상태 코드 레지스트리에 등록된, 널리 쓰이는 코드만 모았습니다. 비표준이거나 출처가 불분명한 코드는 넣지 않았습니다.
왜 305, 306 같은 코드는 빠져 있나요?
305(Use Proxy)는 보안 문제로 사실상 폐기되었고, 306은 더 이상 쓰이지 않습니다. 실제로 마주칠 일이 거의 없는 코드라서, 혼란을 줄이기 위해 널리 쓰이는 코드 위주로 목록을 구성했습니다.
상태 코드의 설명이 법적 조언이나 사양 전체를 대신하나요?
아니요 — 여기 설명은 빠르게 참고하기 위한 간단한 요약입니다. 정확한 동작이 중요한 상황이라면 관련 RFC나 최신 HTTP 사양을 직접 확인하세요.
401과 403의 진짜 차이는 무엇인가요?
401 Unauthorized는 사실 '인증되지 않음'을 뜻합니다. 서버가 당신이 누구인지 모르는 상태로, 보통 자격 증명이 없거나 잘못됐을 때 발생합니다. 403 Forbidden은 서버가 당신이 누구인지는 알지만 유효한 자격 증명이 있어도 해당 리소스에 접근할 권한이 없다는 뜻입니다.
리소스가 사라졌을 때 404를 써야 하나요, 410을 써야 하나요?
리소스가 존재하지 않고 예전에 존재했는지 여부를 모르거나(혹은 말하고 싶지 않다면) 404 Not Found를 쓰세요. 리소스가 예전에는 확실히 존재했지만 영구적으로 제거되었다는 것을 안다면 410 Gone을 쓰세요. 클라이언트와 검색 엔진에게 더 이상 요청하지 말라는 신호를 줍니다.
리다이렉트에 301, 302, 307, 308 중 언제 무엇을 써야 하나요?
301과 308은 영구 리다이렉트이고, 302와 307은 임시 리다이렉트입니다. 이전 쌍(301/302)과 최신 쌍(307/308)의 차이는, 307과 308은 리다이렉트된 요청에서도 요청 메서드와 본문이 보존됨을 보장하는 반면, 301과 302는 역사적으로 클라이언트가 POST를 GET으로 바꿀 수 있도록 허용했다는 점입니다.
서버가 더 구체적인 코드 대신 왜 500을 반환했나요?
500 Internal Server Error는 처리되지 않은 예외 같은 예상치 못한 서버 측 오류를 위한 일반적인 포괄 코드입니다. 보통 서버의 오류 처리 로직이 실패 상황을 더 구체적인 4xx나 5xx 코드로 매핑하지 못했다는 뜻이므로, 실제 원인은 서버 로그를 확인해보세요.