Route handler contract

API 라우트는 입력 검증, 작업 실행, 응답 형식을 하나의 계약으로 묶는다

GET과 POST 핸들러는 메서드만 다를 뿐, 요청을 확인하고 일관된 JSON 응답을 돌려주는 기준은 같습니다.

1 요청 읽기

`NextRequest`

검색 조건, 동적 파라미터, JSON 본문처럼 필요한 입력을 명확히 꺼냅니다.

2 검증

누락된 필드, 잘못된 ID, 인증 상태를 작업 전에 먼저 확인합니다.

3 작업

데이터베이스나 외부 API 작업은 검증을 통과한 뒤에만 실행합니다.

4 응답

성공과 실패 모두 상태 코드와 메시지 형식을 일관되게 돌려줍니다.