REFERENCEAPIHTTP
HTTP 상태 코드 사전
1xx~5xx의 모든 표준 HTTP 상태 코드 상세 설명 및 백엔드 개발자 실무 베스트 가이드를 제공합니다.
100
Continue서버가 요청 헤더를 수신했으며 클라이언트가 요청 본문을 계속 전송해야 함을 나타냅니다.
101
Switching Protocols클라이언트가 요청한 프로토콜 전환 요구를 서버가 수락하여 프로토콜을 변경 중임을 의미합니다.
102
Processing서버가 요청을 수신하여 처리 중이나 아직 완전한 응답을 줄 수 없음을 알립니다.
103
Early Hints서버가 최종 응답을 준비하는 동안 클라이언트가 리소스를 미리 로드(Preload)할 수 있도록 힌트를 제공합니다.
200
OK요청이 성공적으로 처리되었습니다. 정보가 응답 본문에 반환됩니다.
201
Created요청이 성공적이었으며, 그 결과로 새로운 리소스가 생성되었습니다.
202
Accepted요청을 접수하였으나 아직 처리가 완료되지 않았습니다.
204
No Content요청이 성공했으나 응답 본문(Body)에 보낼 데이터가 없습니다.
206
Partial Content클라이언트가 요청한 범위(Range) 헤더에 따라 리소스의 일부분만 전송합니다.
301
Moved Permanently요청한 리소스의 URI가 영구적으로 새 주소로 변경되었습니다.
302
Found (Moved Temporarily)요청한 리소스가 임시적으로 다른 URI에 있음을 의미합니다.
304
Not Modified리소스가 마지막 요청 이후 변경되지 않았으므로 캐시된 버전을 그대로 사용할 수 있습니다.
307
Temporary Redirect리소스가 임시적으로 위치를 옮겼으며, 클라이언트는 원래의 HTTP 메서드(POST 등)를 변경 없이 유지해야 합니다.
308
Permanent Redirect리소스가 영구적으로 이전되었으며, 원래의 HTTP 메서드를 변경 없이 유지하여 다시 요청해야 합니다.
400
Bad Request잘못된 문법, 유효하지 않은 포맷 등 클라이언트의 요청이 부적절하여 서버가 처리할 수 없습니다.
401
Unauthorized인증 정보(Access Token, Session)가 누락되었거나 유효하지 않아 리소스에 접근할 수 없습니다.
403
Forbidden클라이언트가 누구인지는 알지만(인증 완료), 해당 권한으로는 이 리소스에 접근할 권리가 없습니다.
404
Not Found요청한 URI를 서버에서 찾을 수 없습니다. 경로가 잘못되었거나 존재하지 않는 데이터입니다.
405
Method Not Allowed요청한 리소스가 해당 HTTP Method(GET, POST 등)의 요청을 지원하지 않습니다.
408
Request Timeout서버가 정해진 시간 내에 클라이언트의 전체 요청 내용을 수신하지 못하고 대기 시간이 만료되었습니다.
409
Conflict서버의 현재 상태와 충돌이 발생했습니다. 주로 중복 데이터 등록 시 발생합니다.
410
Gone요청 리소스가 영구적으로 삭제되었으며 새 위치도 알 수 없습니다. (404보다 강력한 삭제 정보)
413
Payload Too Large요청 본문의 크기가 서버가 허용하는 최대 제한 한도를 초과했습니다.
415
Unsupported Media Type요청 페이로드의 미디어 포맷(Content-Type)을 서버가 처리할 수 없습니다.
422
Unprocessable Entity요청 문법은 올바르나, 논리적 오류로 인해 명령을 처리할 수 없습니다.
429
Too Many Requests클라이언트가 짧은 시간 내에 너무 많은 요청을 보냈습니다. (디도스 방지 및 API 사용량 제한)
500
Internal Server Error서버 내부에서 예상치 못한 오류가 발생하여 요청을 완료할 수 없습니다.
501
Not Implemented서버가 요청을 완료하는 데 필요한 기능을 지원하지 않습니다. (아직 구현되지 않은 엔드포인트)
502
Bad Gateway서버가 게이트웨이 또는 프록시 역할을 수행 중, 업스트림 서버로부터 잘못된 응답을 받았습니다.
503
Service Unavailable서버가 일시적인 서버 점검이나 과부하 등으로 인해 요청을 처리할 수 없습니다.
504
Gateway Timeout게이트웨이/프록시 서버가 요청을 처리하는 데 필요한 업스트림 서버의 응답을 제한 시간 내에 받지 못했습니다.
200
OK
2xx Success (성공)설명 (Korean)
요청이 성공적으로 처리되었습니다. 정보가 응답 본문에 반환됩니다.
Description (English)
The request has succeeded. The information returned with the response depends on the method.
실무 개발 가이드 (Best Practice)
일반적인 GET, PUT, POST 성공 시 가장 보편적으로 사용합니다. 빈 응답이 아닌 결과 데이터가 존재할 때 적합합니다.
The most common success code. Standard response for successful GET, PUT, or POST requests returning data.
도구 설명 및 사용 방법
1xx~5xx의 모든 표준 HTTP 상태 코드 상세 설명 및 백엔드 개발자 실무 베스트 가이드를 제공합니다.
사용 단계
1
검색란에 상태 코드 번호(예: 403) 또는 키워드(예: 권한)를 적어 바로 조회합니다.
2
1xx ~ 5xx 퀵 탭 필터링을 눌러 특정 오류 그룹들만 모아서 간편하게 탐색합니다.
3
상태 카드 목록에서 타겟 코드를 선택하면 우측 정보창에 상세 한글/영문 가이드라인이 표시됩니다.
4
코드 이름의 퀵 복사 단추나 하단 MDN 연동 링크를 통해 공식 스펙을 추가로 숙지합니다.
작동 원리 및 상세 설명
HTTP 상태 코드 가이드는 IANA 공식 HTTP 프로토콜 규격서(RFC 7231)에 의거해 구조화되었습니다. 각 상태 카테고리를 정보 제공(1xx), 성공(2xx), 리다이렉션(3xx), 클라이언트 오류(4xx), 서버 오류(5xx)의 5개 영역으로 매핑 정렬하고 백엔드 엔지니어링 실무 베스트 가이드를 결합해 개발자에게 입체적으로 제공합니다.
자주 묻는 질문 (FAQ)
401 Unauthorized와 403 Forbidden의 실무 차이는 무엇인가요?
401은 사용자가 누구인지 전혀 파악되지 않은 인증 실패(로그인 안 됨) 상태이고, 403은 로그인은 되어 사용자는 알지만 해당 리소스에 접근할 수 있는 권한이 박탈된 인가 실패 상태를 가리킵니다.
502 Bad Gateway와 504 Gateway Timeout의 차이는 무엇인가요?
502는 게이트웨이(예: Nginx)가 뒤쪽 백엔드 WAS 서버로부터 잘못된 응답(서버 죽음 등)을 전달받은 것이고, 504는 백엔드 서버가 정해진 타임아웃 시간 내에 게이트웨이로 응답을 돌려주지 못해 통신 지연이 발생한 상태를 말합니다.
코드 사용 예시
Express.js 프레임워크에서의 예외 상태 코드 반환 구현 코드 예제
javascript
app.get('/api/resource', (req, res) => {
if (!req.isAuthenticated()) {
// 401 Unauthorized 상태 반환
return res.status(401).json({ error: "Authentication required" });
}
if (req.user.role !== 'admin') {
// 403 Forbidden 상태 반환
return res.status(403).json({ error: "Access denied" });
}
res.status(200).json({ data: "Resource detail" });
});보안 시나리오에 따라 적정한 REST API 표준 4xx 계열 오류 상태 코드를 매핑 반환하는 백엔드 구현 예시입니다.