Route Handler Matrix

HTTP 메서드별 응답 설계

입력 위치와 성공·오류 상태 코드를 먼저 정하면 NextResponse.json과 null 응답 선택이 흔들리지 않습니다.

메서드

읽는 입력

성공 응답

실패 응답

반환 선택

GET

params · searchParams

200 + 조회 데이터

404

NextResponse.json(data)

POST

request body

201 + 생성 결과

400

NextResponse.json(created)

PUT

params + full body

200 + 전체 교체

400 / 404

NextResponse.json(updated)

PATCH

params + partial body

200 + 변경 필드

400 / 404

NextResponse.json(patched)

DELETE

params

204 + 본문 없음

404

new NextResponse(null)