📚 Reference

• 공식 문서 1

📜 Chapter

API Routes

Route Handlers

• Route Handlers
• 웹 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) 객체를 반환한다.

// app/api/users/route.ts

import { NextResponse } from 'next/server';

// GET 요청 처리
export async function GET(request) {
  const users = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
  return NextResponse.json(users);
}

// POST 요청 처리
export async function POST(request) {
  const newUser = await request.json();
  // 데이터베이스에 새 사용자 추가 로직
  return NextResponse.json({ message: 'User added successfully' });
}