200HTTP 상태코드 조회
HTTP 상태코드와 의미 조회
100
Continue
서버가 요청 헤더를 받았으며, 클라이언트가 본문을 전송해야 함
101
Switching Protocols
서버가 프로토콜 전환을 수락
200
OK
요청이 성공적으로 처리됨
201
Created
요청이 성공하여 새 리소스가 생성됨
204
No Content
요청이 성공했지만 반환할 콘텐츠 없음
301
Moved Permanently
리소스가 영구적으로 이동됨
302
Found
리소스가 임시로 이동됨
304
Not Modified
캐시된 버전 사용 가능
400
Bad Request
잘못된 요청 구문 또는 유효하지 않은 매개변수
401
Unauthorized
인증이 필요함 (로그인 필요)
403
Forbidden
서버가 요청을 거부 (권한 없음)
404
Not Found
요청한 리소스를 찾을 수 없음
405
Method Not Allowed
요청 메서드가 허용되지 않음
408
Request Timeout
서버가 요청 대기 시간 초과
409
Conflict
요청이 현재 서버 상태와 충돌
413
Payload Too Large
요청 본문이 너무 큼
422
Unprocessable Entity
요청은 잘 만들어졌으나 처리할 수 없음
429
Too Many Requests
너무 많은 요청 (Rate Limiting)
500
Internal Server Error
서버 내부 오류
502
Bad Gateway
게이트웨이/프록시 서버가 잘못된 응답 수신
503
Service Unavailable
서버가 일시적으로 요청 처리 불가 (과부하/유지보수)
504
Gateway Timeout
게이트웨이/프록시 서버가 응답 대기 시간 초과
HTTP 상태 코드 완벽 이해
HTTP 상태 코드는 서버가 클라이언트 요청에 응답할 때 반환하는 3자리 숫자 코드입니다. 웹 개발, API 설계, 서버 디버깅 모든 영역에서 정확히 알아야 하는 핵심 표준입니다. 1xx(정보), 2xx(성공), 3xx(리다이렉션), 4xx(클라이언트 오류), 5xx(서버 오류) 5개 구간으로 분류됩니다.
100/200/300/400/500번대 개요
- 1xx 정보: 요청을 받아 처리 중 (100 Continue, 101 Switching Protocols)
- 2xx 성공: 요청이 정상 처리됨 (200 OK, 201 Created, 204 No Content)
- 3xx 리다이렉션: 요청 완료를 위해 추가 작업 필요 (301, 302, 304, 307, 308)
- 4xx 클라이언트 오류: 요청에 문제가 있음 (400, 401, 403, 404, 429)
- 5xx 서버 오류: 서버가 유효한 요청을 처리 못함 (500, 502, 503, 504)
자주 헷갈리는 코드 비교
| 코드 | 의미 | 핵심 차이 |
|---|---|---|
| 401 | Unauthorized | 인증 없음 (로그인 필요) |
| 403 | Forbidden | 인증됐지만 권한 없음 |
| 302 | Found | 임시 리다이렉트, 메서드 변경 가능 |
| 307 | Temporary Redirect | 임시 리다이렉트, 메서드 유지 |
| 308 | Permanent Redirect | 영구 리다이렉트, 메서드 유지 (301 대체) |
| 400 | Bad Request | 구문 오류, 유효하지 않은 요청 |
| 422 | Unprocessable Entity | 구문은 맞지만 의미론적 오류 (유효성 실패) |
REST API에서 적절한 코드 선택
- 리소스 생성 성공 → 201 Created + Location 헤더
- 삭제 후 반환 없음 → 204 No Content
- 유효성 검증 실패 → 422 Unprocessable Entity (422 권장, 400도 허용)
- Rate limit 초과 → 429 Too Many Requests + Retry-After 헤더
- 서버 일시 점검 → 503 Service Unavailable + Retry-After 헤더
사용 방법
- 검색창에 상태 코드 번호(예: 404) 또는 키워드(예: timeout)를 입력합니다.
- 색상으로 구분된 카테고리를 통해 코드의 성격을 직관적으로 파악합니다.