Route Handler

API 라우트는 파일 경로, 메서드 함수, 응답 계약이 맞물릴 때 안정적이다

route.ts 안에서 요청을 읽고 필요한 작업을 실행한 뒤 일관된 JSON과 상태 코드를 반환합니다.

GET

읽기 요청 처리

쿼리나 동적 파라미터를 읽고 필요한 데이터를 조회해 JSON으로 돌려줍니다.

POST

쓰기 요청 처리

요청 본문을 검증한 뒤 생성 작업을 실행하고 생성된 결과와 상태 코드를 반환합니다.

[id]

동적 경로 처리

세그먼트 파라미터를 사용해 특정 리소스 조회, 수정, 삭제 요청을 구분합니다.

서버 경계

API 라우트는 브라우저에서 숨겨야 할 작업을 서버 안으로 모은다

데이터베이스 연결, 외부 API 키, 권한 확인은 클라이언트 컴포넌트가 아니라 Route Handler에서 다룹니다.

구현 점검

입력검색 조건, JSON 본문, 동적 파라미터를 필요한 형태로 꺼냅니다.
예외필수 값 누락, 권한 없음, 리소스 없음 상황의 응답을 분리합니다.
테스트브라우저, curl, API 클라이언트로 실제 상태 코드와 JSON을 확인합니다.