Route handler
API 라우트는 파일 경로를 HTTP 엔드포인트로 바꾼다
App Router의 `app/api/**/route.ts`는 요청을 받아 서버에서 처리하고 Response를 돌려준다.
File
app/api/users/route.ts
서버 코드 위치
URL
/api/users
클라이언트 호출 경로
Method
GET/POST 함수
HTTP 동작 분리
Response
JSON/redirect/status
클라이언트 반환
요소
역할
실수
route.ts
엔드포인트 선언
page.tsx와 혼동
method export
요청별 처리
없는 메서드 405
Response
상태/헤더 포함
plain object 반환 착각
핵심
API route는 파일 이름이 아니라 HTTP method와 Response 계약으로 이해해야 한다.