1. 개념 요약

API Routes는 Next.js 프로젝트 안에서 백엔드 API를 구현할 수 있도록 해주는 기능이다. 별도의 서버 없이도 pages/api 폴더 내부에 파일을 만들어 API 서버처럼 사용할 수 있다.

2. 배경 지식

• Next.js는 프론트엔드 프레임워크지만, pages/api 디렉토리를 통해 백엔드 역할도 일부 수행할 수 있음
• pages/api/*.ts(x) 파일은 페이지가 아닌 API 엔드포인트로 취급됨
• 클라이언트 사이드 코드에는 포함되지 않음 (서버 전용)
• 전통적인 방식처럼 req, res 객체를 받아 Node.js 방식으로 작성 가능

예시:

// pages/api/hello.ts
export default function handler(req, res) {
  res.status(200).json({ message: 'Hello API' });
}

3. 상세 설명

활용 목적

• Frontend와 Backend를 하나의 프로젝트에서 관리 가능
• 간단한 데이터 처리, 테스트용 API 구현 등에 유용
• 백엔드 분리 없이 API를 사용할 수 있어 프로토타이핑에 적합