HTTP status code는 첫 자리 숫자로 다섯 부류로 묶이며, 올바른 것을 고르면 client가 body를 파싱하지 않고도 올바르게 반응할 수 있다.
2xx Success — the request worked
3xx Redirection — further action / resource moved
4xx Client error — the caller did something wrong
5xx Server error — the server failed
2xx
200 OK — 일반적 성공(GET, PUT, PATCH).201 Created — 리소스가 생성됨(Location 헤더를 반환).202 Accepted — 비동기 처리를 위해 수락됨, 아직 완료 안 됨.204 No Content — body 없는 성공(DELETE에 흔함).4xx
400 Bad Request — 잘못된 구문 또는 유효하지 않은 입력.401 Unauthorized — 인증되지 않음(자격 증명 없음/무효).403 Forbidden — 인증되었으나 허용되지 않음.404 Not Found — 리소스가 존재하지 않음.409 Conflict — 현재 상태와 충돌(예: 이메일 중복).422 Unprocessable Entity — 구문은 올바르나 validation 실패.429 Too Many Requests — rate limit에 걸림.5xx
500 Internal Server Error — 예상치 못한 server 결함.503 Service Unavailable — 일시적으로 다운/과부하.POST /users → 201 Created
Location: /users/42
DELETE /users/42 → 204 No Content
GET /users/999 → 404 Not Found
{ "error": "user not found" }
면접관이 파고드는 핵심 구분: 401("당신은 누구인가?") vs 403("당신을 알지만, 안 됨"), 그리고 400(잘못된 구문) vs 422(올바른 구문, 유효하지 않은 데이터).
status code는 REST response의 주된 신호다 — client, proxy, 모니터링, retry 로직이 모두 그것을 기준으로 작동하므로, 이를 올바르게 하는 것은 상호운용성에 필수다. 흔한 실패는 { "error": ... } body와 함께 200 OK를 반환하는 것이다: 모든 client가 호출 성공 여부를 알려고 body를 파싱하게 강제하고, 범용 HTTP 도구를 깨뜨리며, 모니터링에서 실패를 숨긴다. 정확한 코드는 자동 동작도 이끈다: 429나 503은 잘 만든 client에게 물러나 retry하라고 말하고, 4xx는 "retry하지 말고 request를 고치라"고 말한다. 면접관은 이 질문으로 당신이 HTTP를 멍청한 전송 수단이 아니라 계약으로 이해하는지, 그리고 미묘한 쌍(401/403, 400/422)을 올바르게 구별하는지 — 실제 API를 만들고 소비해 본 사람의 특징 — 를 확인한다.
주니어부터 시니어까지 상세한 답변이 포함된 IT 면접 질문 라이브러리.
후원하기