📚 Reference

• 공식 문서 1

📜 Chapter

API Routes

Server Component

‣

Server Actions

Route Handlers

• Route Handlers
• app/api/**/route.ts의 API 엔드포인트. 데이터/파일/웹훅/프록시 처리.
• 웹 API를 구축하기 위해 사용되는 기능이다.
• 이들은 기존 Pages Router의 API Routes를 대체하며, GET, POST, PUT, DELETE와 같은 HTTP 요청에 응답하는 서버 측 코드를 작성하는 데 사용된다.
• 파일 기반 라우팅 시스템을 따르기 때문에, app 디렉터리 내에 특정 파일명 규칙을 사용해 정의할 수 있다.

특징

파일명 규칙

Route Handlers는 app 디렉터리 내의 route.ts, route.js 등의 파일로 정의된다.

예를 들어, app/api/users/route.ts 파일은 /api/users 경로의 요청을 처리하는 핸들러가 된다.

함수 기반의 HTTP 메서드

각 HTTP 메서드는 파일 내에서 GET, POST, PUT, DELETE와 같은 이름의 함수로 정의된다.

이 함수들은 요청(request) 객체를 인자로 받고, 응답(response) 객체를 반환한다.