🚥 HTTP 상태코드 선택 | 어떤 코드로 응답할까?

응답할 상황

응답 본문을 담을 것인가

옮김이 영구적인가 (옮김 상황)

메서드를 그대로 유지해야 하는가 (옮김 상황)

Location 값 (생성·옮김 상황)

받는 메서드 목록 (메서드 불허 상황)

Retry-After 초 (선택)

인증 방식 이름 (인증 없음 상황)

이 상황에 맞는 상태코드

후보 코드 개수-

함께 보낼 필수 헤더-

본문을 담을 수 있는가-

코드	규격이 정한 뜻	어디가 정의하는가

코드 번호를 넣어 뜻을 찾는 사전이 아니라, 상황에서 코드를 고르는 쪽으로만 씁니다. 메서드를 고르는 일은 다른 도구의 몫입니다. 여기 적은 뜻은 규격이 정의한 범위까지이고, 어느 코드를 쓸지에 관행이 끼어드는 자리는 관행이라고 따로 밝혔습니다.

도구 설명

무엇을 응답할 상황인지 고르면 그 상황에 맞는 상태코드와 함께 보내야 하는 헤더를 알려 주고, 바로 붙여 볼 수 있는 응답 머리부를 만들어 줍니다. 생성·수정·삭제·접수부터 검증 실패, 권한, 충돌, 전제조건, 요청 과다까지 고를 수 있고, 본문을 담을지 여부에 따라 코드가 달라지는 자리도 반영합니다. 수정 성공은 본문을 담으면 200, 담지 않으면 204 가 됩니다.

후보가 둘 이상인 상황에서는 다른 선택지와 그 선택지를 쓰는 조건을 함께 적습니다. 2026년 10월 기준 RFC 9110 이 정의한 뜻을 기준으로 삼고, 추가 상태코드를 정의한 RFC 6585 가 출처인 코드는 따로 표시했습니다. 규격이 정하지 않은 자리는 관행이라고 밝혔습니다. 값 검증 실패에 422 를 쓰는 것, 403 대신 404 로 존재를 숨기는 것이 그런 자리입니다.

필수 헤더는 빠지면 오류로 알려 줍니다. 401 에는 인증 방식을 알리는 헤더가, 405 에는 받는 메서드 목록이, 생성과 옮김에는 Location 이 필요합니다. 이 도구는 코드 번호로 뜻을 찾는 사전이 아니고, 어떤 메서드를 쓸지 고르는 일도 다루지 않습니다.

자주 묻는 질문

204 응답에 본문을 담으면 안 되나요?

담을 수 없습니다. 204 는 헤더가 끝나는 빈 줄에서 응답이 끝나도록 정해져 있어서, 본문을 붙이면 받는 쪽이 그 내용을 다음 응답의 시작으로 잘못 읽을 수 있습니다. 돌려줄 내용이 있다면 200 을 쓰세요.

검증 실패에 400 과 422 중 무엇을 쓰나요?

규격이 정해 주지 않은 자리라 관행입니다. 규격은 422 를 "담긴 내용을 처리할 수 없다" 로 정의할 뿐 검증 실패 전용으로 정하지 않았습니다. 형식이 깨진 요청에 400, 형식은 맞고 값이 규칙에 어긋난 요청에 422 를 쓰는 편이 흔하지만 팀에서 한 가지로 정해 두는 것이 중요합니다.

이 도구가 하지 않는 것은 무엇인가요?

코드 번호를 넣어 뜻을 찾는 사전 기능과 메서드 선택은 하지 않습니다. 상황에서 코드를 고르고 응답 머리부를 만드는 일만 합니다.

🚥반환 HTTP 상태코드 선택 가이드

관련된 도구

HTTP 메서드 선택 가이드

REST 리소스 URL 설계 가이드

도구 설명

자주 묻는 질문

관련된 도구

HTTP 메서드 선택 가이드

REST 리소스 URL 설계 가이드

도구 설명

자주 묻는 질문

같은 카테고리 도구