HTTP 상태 코드 참조표

HTTP 상태 코드가 무슨 의미인지 찾아봅니다.

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