Route Handler

App Router API 라우트

폴더 경로가 엔드포인트가 되고 GET, POST 같은 함수 이름이 요청 메서드와 직접 연결됩니다.

API 파일

route.ts 엔드포인트 위치

App Router에서 폴더 경로가 URL이 되고 route.ts가 해당 경로의 서버 요청을 받습니다.

읽기 메서드

GET 함수 조회 응답

목록 조회나 상세 조회를 처리하고 캐시 정책, 상태 코드, 빈 결과 응답을 함께 정합니다.

생성 메서드

POST 함수 입력 검증

폼 제출이나 새 데이터 생성 요청을 서버에서 받아 body 검증과 저장 실패 처리를 수행합니다.

경로 변수

동적 라우트 상세 API

[id] 폴더로 요청 파라미터를 받아 대상 조회, 권한 확인, 404 응답을 구성합니다.

엔드포인트

파일 위치가 URL 구조를 결정합니다

app/api/posts/route.ts는 /api/posts 요청을 처리하고 동적 폴더는 파라미터 기반 API로 이어집니다.

API 구성 요소

GET 함수query string, pagination, 404 처리처럼 읽기 요청의 분기 조건을 모읍니다.
POST 함수폼 입력을 신뢰하지 않고 schema 검증 뒤 생성 결과와 Location 정보를 돌려줍니다.
동적 라우트[id] 값으로 대상을 찾고 존재 여부, 소유권, 공개 범위를 차례로 확인합니다.