레퍼런스

HTTP 상태 코드 정리

API·웹 개발에서 마주치는 HTTP 상태 코드의 의미와 원인, 대처 방법을 한국어로 정리했습니다. 코드 번호로 검색하거나 아래에서 골라 보세요.

1xx 정보 응답

요청을 받았고 처리가 진행 중임을 알립니다.

100Continue · 계속서버가 요청의 첫 부분을 받았고 계속 보내도 된다는 임시 응답입니다.101Switching Protocols · 프로토콜 전환서버가 클라이언트의 프로토콜 전환 요청에 동의했습니다.103Early Hints · 이른 힌트최종 응답 전에 미리 로드할 리소스 등 일부 헤더를 먼저 보냅니다.

2xx 성공

요청이 성공적으로 처리되었습니다.

200OK · 성공요청이 정상적으로 처리되었습니다. 가장 일반적인 성공 응답입니다.201Created · 생성됨요청이 성공했고 새 리소스가 생성되었습니다.202Accepted · 접수됨요청을 접수했지만 처리는 아직 완료되지 않았습니다.204No Content · 내용 없음성공했지만 응답 본문이 없습니다.206Partial Content · 부분 콘텐츠리소스의 일부분만 응답합니다.

3xx 리다이렉션

요청을 완료하려면 추가 동작(주로 이동)이 필요합니다.

301Moved Permanently · 영구 이동리소스가 새 URL로 영구적으로 이동했습니다.302Found · 일시적 이동리소스가 일시적으로 다른 URL에 있습니다.303See Other · 다른 위치 참조다른 URL을 GET 방식으로 조회하라는 의미입니다.304Not Modified · 변경 없음리소스가 바뀌지 않았으니 캐시를 그대로 사용하면 됩니다.307Temporary Redirect · 임시 리다이렉트임시 이동이며 HTTP 메서드를 그대로 유지합니다.308Permanent Redirect · 영구 리다이렉트영구 이동이며 HTTP 메서드를 그대로 유지합니다.

4xx 클라이언트 오류

요청에 문제가 있어 서버가 처리를 거부했습니다.

400Bad Request · 잘못된 요청요청 형식이 잘못되어 서버가 이해할 수 없습니다.401Unauthorized · 인증 필요인증이 필요하거나 인증 정보가 유효하지 않습니다.403Forbidden · 접근 금지인증은 되었지만 접근 권한이 없습니다.404Not Found · 찾을 수 없음요청한 리소스를 찾을 수 없습니다. 가장 유명한 오류입니다.405Method Not Allowed · 허용되지 않은 메서드해당 URL에서 허용되지 않는 HTTP 메서드입니다.406Not Acceptable · 허용 불가클라이언트가 요구한 형식으로 서버가 응답할 수 없습니다.408Request Timeout · 요청 시간 초과서버가 기다리는 동안 요청이 완료되지 않았습니다.409Conflict · 충돌현재 리소스 상태와 충돌해 요청을 처리할 수 없습니다.410Gone · 영구 삭제됨리소스가 영구적으로 삭제되어 더 이상 제공되지 않습니다.411Length Required · 길이 필요Content-Length 헤더 없이 보낸 요청을 거부했습니다.413Payload Too Large · 본문이 너무 큼요청 본문이 서버가 허용하는 크기를 초과했습니다.414URI Too Long · URI가 너무 김요청 URL이 서버가 처리할 수 있는 길이를 넘었습니다.415Unsupported Media Type · 지원하지 않는 미디어 타입서버가 요청 본문의 형식(Content-Type)을 지원하지 않습니다.418I'm a teapot · 나는 찻주전자농담으로 정의된 상태 코드입니다 — 찻주전자는 커피를 내릴 수 없습니다.422Unprocessable Entity · 처리할 수 없는 엔티티형식은 맞지만 의미상 검증에 실패했습니다.425Too Early · 너무 이른 요청재전송 위험이 있는 이른 요청이라 처리하지 않습니다.426Upgrade Required · 업그레이드 필요클라이언트가 다른 프로토콜로 업그레이드해야 합니다.428Precondition Required · 전제 조건 필요조건부 요청이 필요합니다(동시 수정 충돌 방지).429Too Many Requests · too 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 버전 미지원요청한 HTTP 버전을 서버가 지원하지 않습니다.507Insufficient Storage · 저장 공간 부족서버 저장 공간이 부족해 요청을 처리할 수 없습니다.511Network Authentication Required · 네트워크 인증 필요네트워크에 접근하기 전에 인증이 필요합니다.