Route Handler를 이용해 api 엔드포인트 만들기

라우트 핸들러(Route Handler)에 대해 깔끔하게 정리해드리겠습니다:

라우트 핸들러란?

• NextJS에서 API 엔드포인트를 만들기 위한 특별한 파일입니다
• 일반적인 페이지를 렌더링하는 대신 데이터를 주고받는 역할을 합니다

 

주요 특징

1. 파일 구조:
   • route.js 파일로 생성 (페이지용 page.js와 다름)
   • API 폴더 등에 위치시키며, 레이아웃이 필요하지 않음
2. 지원하는 HTTP 메서드:
   • GET, POST, PATCH, PUT, DELETE 등
   • 각 메서드명으로 함수를 export하여 사용
3. 작동 방식:
   • 자동으로 request 객체를 받아옴
   • JSON 데이터나 일반 텍스트 등을 응답으로 반환 가능
   • 클라이언트의 요청을 처리하고 응답을 보내는 역할

 

- 코드 예시

export function GET(request) {
  console.log(request);

  // return Response.json();
  return new Response("Hello!");
}

// export function POST(request) {}

 

사용 사례

• 모바일 앱과의 데이터 통신
• 백그라운드에서 데이터 저장/조회
• 외부 클라이언트와의 API 통신
• 페이지 내에서 필요한 데이터 요청 처리

라우트 핸들러는 NextJS 애플리케이션에서 API 기능이 필요할 때 매우 유용한 도구입니다.

특히 여러 클라이언트(웹, 모바일 등)가 동일한 백엔드와 통신해야 할 때 효과적으로 활용할 수 있습니다.