API ROUTE

Next.js API 라우트는 파일 경로를 서버 측 엔드포인트로 바꾸는 구조다

App Router에서는 api 폴더 아래 route 파일이 HTTP 메서드별 요청 처리 지점이 된다.

Path

폴더 구조가 API URL 경로로 매핑된다.

Handler

GET, POST 같은 함수가 요청 메서드를 처리한다.

Server Runtime

DB, 외부 API, 인증 같은 서버 작업을 수행한다.

Response

NextResponse로 상태와 JSON 결과를 반환한다.

설계 기준: UI 전용 로직과 서버 비밀값이 필요한 로직을 API 경계에서 분리한다.