응답 계약

메서드 응답 계약

Route Handler를 작성할 때는 CRUD 의미와 상태 코드를 함께 설계해야 클라이언트 fetch 분기가 단순해집니다.

조회

GET

대상 리소스가 있으면 본문과 200을 반환하고, 없으면 404로 끝냅니다.

200 / 404
생성

POST

본문 검증을 통과한 뒤 생성된 리소스와 201을 반환합니다.

201 Created
수정

PUT / PATCH

필수값 누락은 400, 수정 대상 부재는 404로 분리합니다.

400 + 404
삭제

DELETE

삭제 성공 후 본문이 필요 없으면 204 응답으로 계약을 좁힙니다.

204 No Content
분기
서버 판정
응답
클라이언트 처리
입력 오류
body 필수값 누락
400 JSON
폼 메시지 표시
대상 없음
params.id 조회 실패
404 JSON
상세 화면 이탈
삭제 완료
filter 후 길이 감소
204 빈 본문
목록 다시 읽기