HTTP Method

HTTP 메서드 의도

Next.js Route Handler에서는 메서드 함수별로 입력, 작업, 응답 상태를 나누어 RESTful 의도를 분명히 합니다.

NextRequest

입력 수집

URL, 검색 파라미터, 쿠키, JSON 본문을 요청 목적에 맞게 읽습니다.

Handler

메서드별 분기

GET, POST, PUT, DELETE 함수를 분리해 같은 경로에서도 작업 의도를 구분합니다.

NextResponse

상태와 JSON 반환

성공 응답뿐 아니라 400, 401, 404, 500 형식도 클라이언트가 처리하기 쉽게 맞춥니다.

RESTful 기준

동일한 URL이라도 메서드가 다르면 계약도 달라집니다

/api/todos는 GET이면 목록 조회, POST이면 생성 요청처럼 메서드가 리소스 작업을 설명합니다.

구현 시 확인할 항목

검사필수 파라미터와 본문 구조를 작업 전에 확인합니다.
보안권한이 필요한 메서드는 세션과 역할을 먼저 비교합니다.
캐시조회 요청과 변경 요청의 캐시 정책을 섞지 않습니다.