HTTP 상태 코드: 완전한 참조

HTTP 상태 코드는 웹 API의 공통 언어입니다. 올바른 것을 선택하면 클라이언트에 정확히 무슨 일이 있었는지 전달됩니다.

2xx: 성공

• 200 OK
• 201 Created (Location 헤더 포함)
• 202 Accepted (비동기 큐잉)
• 204 No Content (DELETE 등)

3xx: 리다이렉션

• 301 Moved Permanently (영구 캐시)
• 302 Found (대부분 POST→GET 변환)
• 307/308 (메서드 보존)

모던 API는 307/308 권장.

4xx: 클라이언트 오류

• 400 잘못된 요청
• 401 미인증 (이름과 달리)
• 403 인증됐지만 권한 없음
• 404 없음
• 422 시맨틱 검증 실패
• 429 레이트 리밋 (Retry-After)

5xx: 서버 오류

• 500 내부 오류
• 502 Bad Gateway
• 503 일시 과부하 (Retry-After)
• 504 Gateway Timeout

흔한 실수

200 + {"error":"..."} 반환은 클라이언트가 상태로 반응 못 함.