NEXT · API ROUTE
동적 API 라우트의 CRUD 요청 매핑
동적 API 라우트는 URL의 [id] 값을 params로 받고, HTTP 메서드에 따라 조회, 수정, 삭제 로직을 나누는 구조입니다.
요청 처리 흐름
route
요청 URL
/api/users/42처럼 id가 경로에 포함됩니다.
params.id
라우트 핸들러가 동적 세그먼트를 읽습니다.
GET
id에 해당하는 사용자 정보를 조회합니다.
PUT
본문을 검증하고 사용자 정보를 갱신합니다.
DELETE
대상을 삭제하거나 비활성화합니다.
status
200, 404, 400 등 의미 있는 응답을 반환합니다.
URL
→
params
→
method
→
logic
→
status
설계 기준
http
존재 확인
없는 id면 404를 명확히 반환합니다.
입력 검증
PUT 본문은 타입과 필수값을 먼저 검사합니다.
권한 체크
수정과 삭제는 사용자 권한을 함께 확인합니다.
응답 일관성
성공과 실패 응답 형식을 문서화합니다.