APP ROUTER CHECKBOARD

API route는 경로, 메서드, 검증, 응답을 한 흐름으로 설계한다

route.ts 파일을 만들 때 요청이 어디로 들어오고, 어떤 함수가 처리하며, 어떤 상태 코드로 끝나는지 먼저 맞춰 두면 구현이 단순해집니다.

1 파일 경로 app/api/users/route.ts

폴더 구조가 그대로 /api/users 엔드포인트가 됩니다.

2 HTTP 메서드 export async function POST()

GET, POST, PUT, DELETE 함수로 요청 의도를 분리합니다.

3 입력 검증 request.json()

본문, 쿼리, params를 읽고 필수값과 타입을 확인합니다.

4 응답 코드 NextResponse.json()

200, 201, 400, 401, 404처럼 의미 있는 상태를 반환합니다.

5 운영 고려 auth · db · deploy

인증, DB 연결, 서버리스 제한, 배포 환경값을 함께 봅니다.

읽기 API 캐시 전략과 검색 파라미터를 함께 정합니다.

쓰기 API 검증 실패와 생성 성공 응답을 구분합니다.

보호 API 세션, 역할, 소유권 검사를 핸들러 초반에 둡니다.

배포 API 환경 변수와 런타임 제한을 배포 전에 확인합니다.