HTTP 요청 처리

Next API Route 메서드 분기

App Router의 route handler는 파일 하나 안에서 메서드별 함수를 분리해 요청 의미와 응답 형태를 명확히 드러냅니다.

Request
URL · headers · body
GET / POST / PATCH / DELETE
Response
status · json · cache
01

GET

목록 조회나 상세 조회처럼 서버 상태를 읽는 요청을 처리합니다.

02

POST

새 리소스 생성, 로그인, 업로드처럼 서버 상태를 새로 만듭니다.

03

PUT/PATCH

전체 교체 또는 일부 수정을 구분해 검증 로직을 둡니다.

04

DELETE

권한 확인 뒤 삭제하고 캐시 무효화 범위를 정리합니다.

핸들러 기준

  • 요청 바디는 파싱 직후 스키마로 검증합니다.
  • 응답은 상태 코드와 JSON 형태를 함께 고정합니다.
  • 인증, 권한, 캐시 무효화는 메서드별로 빠뜨리지 않습니다.

CRUD 매핑

GETRead
POSTCreate
PATCHUpdate
DELETEDelete