HTTP 상태 코드 참조
요약하면: 일상적인 개발에서 중요한 모든 상태 코드 — 각각의 뜻, 사용되는 때, 함정(401 대 403, 302 대 307) — 입력하면 필터링할 수 있어요.
🔒 설계상 비공개: 모든 것이 이 기기의 브라우저에서 실행돼요. 입력은 서버에 절대 업로드되지 않아요.
| 코드 | 이름 | 의미 |
|---|---|---|
| 100 | Continue | 클라이언트가 요청 본문을 계속 보내야 해요 |
| 101 | 프로토콜 전환 | 프로토콜 업그레이드 승인됨(예: WebSocket으로) |
| 200 | OK | 요청이 성공했어요 — 기본 성공 응답 |
| 201 | 생성됨 | 새 리소스가 생성됐어요(전형적인 POST 성공) |
| 202 | 허용됨 | 비동기 처리를 위해 대기 중, 아직 완료되지 않음 |
| 204 | No Content | 의도적으로 빈 본문으로 성공 |
| 301 | Moved Permanently | 리소스에 새 영구 URL이 있어요 — 링크를 업데이트하세요; SEO 자산이 이전돼요 |
| 302 | 찾음 | 임시 리디렉션 (역사적으로 오용됨; 303/307 참조) |
| 303 | See Other | 다른 URL에서 GET으로 리디렉션 (post/redirect/get) |
| 304 | Not Modified | 캐시된 복사본이 여전히 유효해요 — ETag/Last-Modified로 재검증하세요 |
| 307 | 임시 리디렉션 | 메서드와 본문을 보존하는 임시 리디렉션 |
| 308 | 영구 리디렉션 | 메서드와 본문을 보존하는 영구 리디렉션 |
| 400 | Bad Request | 서버가 요청을 파싱/이해할 수 없어요 |
| 401 | 인증되지 않음 | 인증이 필요하거나 실패했어요(이름과 달리, 인증되지 않았음을 뜻해요) |
| 403 | Forbidden | 인증 여부와 관계없이 접근이 거부돼요 |
| 404 | Not Found | 이 URL에 리소스가 없어요 |
| 405 | Method Not Allowed | 이 리소스에 대해 HTTP 메서드가 지원되지 않아요 |
| 406 | Not Acceptable | Accept 헤더와 일치하는 표현이 없어요 |
| 408 | 요청 시간 초과 | 클라이언트가 요청을 보내는 데 너무 오래 걸렸어요 |
| 409 | 충돌 | 상태 충돌, 예: 편집 충돌 또는 중복 생성 |
| 410 | Gone | 영구적으로 제거됨(404보다 강해요 — 의도적으로 사용돼요) |
| 411 | Length Required | Content-Length 헤더가 필요해요 |
| 413 | Content Too Large | 요청 본문이 서버 제한을 초과해요 |
| 414 | URI가 너무 김 | URL이 서버 제한을 초과해요 |
| 415 | 지원되지 않는 미디어 타입 | 요청 Content-Type이 지원되지 않아요 |
| 418 | I'm a Teapot | RFC 2324 농담 코드, 가끔 커피 내리기를 거부하는 데 사용돼요 |
| 422 | 처리할 수 없는 콘텐츠 | 구문은 괜찮지만 의미론이 검증을 통과하지 못해요(API가 이것을 좋아해요) |
| 425 | 너무 이름 | 서버가 재생됐을 가능성이 있는 요청을 처리하려 하지 않아요 |
| 429 | 요청이 너무 많음 | 속도 제한 도달 — 물러나고, Retry-After를 존중하세요 |
| 500 | Internal Server Error | 일반적인 서버 측 실패 |
| 501 | Not Implemented | 서버가 기능을 지원하지 않아요 |
| 502 | Bad Gateway | 프록시/게이트웨이가 업스트림에서 잘못된 응답을 받았어요 |
| 503 | 서비스를 사용할 수 없음 | 과부하이거나 유지보수 중 — 종종 일시적이며, Retry-After를 포함할 수 있어요 |
| 504 | Gateway Timeout | 프록시/게이트웨이가 업스트림을 기다리다 시간 초과됐어요 |
| 505 | HTTP Version Not Supported | 요청의 HTTP 버전이 지원되지 않아요 |
소개
상태 코드는 모든 응답에 대한 서버의 한 숫자 요약으로, 클래스별로 그룹화돼요: 1xx 정보, 2xx 성공, 3xx 리디렉션, 4xx 클라이언트 오류, 5xx 서버 오류예요. 표는 일하는 개발자가 실제로 만나는 코드를, 실제로 중요한 뉘앙스와 함께 제공해요 — 401은 이름과 달리 인증되지 않음을 뜻하고, 403은 로그인과 관계없이 거부이며, 422는 API 검증 실패, 429는 후퇴를 요구해요. 나열되지 않은 코드(1xx와 실험 코드의 긴 꼬리)는 충분히 드물어 클래스만으로 처리 방법을 알 수 있어요.
자주 묻는 질문
401과 403의 차이는 무엇인가요?
401: 여러분이 누구인지 모릅니다(인증하세요). 403: 알고 있지만, 그래도 안 돼요.
임시 리디렉션에는 302와 307 중 무엇을 쓸까요?
307은 메서드와 본문을 보존해요; 302는 역사적으로 클라이언트가 POST를 GET으로 바꾸는 것을 허용했어요. 새 작업에는 307을(영구적인 경우 308을) 사용해야 해요.