바이브 코딩 사전

Next.js 라우트 핸들러

바이브 코딩 사전

Next.js 라우트 핸들러

Next.js App Router에서 app/api/.../route.ts 파일로 만드는 서버 측 API 엔드포인트이다. GET, POST 같은 HTTP 메서드별 함수를 export하여 브라우저 요청을 받고, 데이터베이스 조회나 외부 API 호출 뒤 JSON 응답을 반환한다. 바이브 코딩에서 AI가 프론트엔드 화면만 만들고 저장·조회 API를 빠뜨리거나, 반대로 클라이언트 코드에 비밀 값을 넣는 실수를 할 수 있으므로 라우트 핸들러는 '브라우저에 노출하면 안 되는 서버 작업을 담는 안전한 경계'로 이해해야 한다.

예시

문의 폼 제출 버튼은 /api/contact로 POST 요청을 보내고, route.ts의 POST 함수가 입력값을 검증한 뒤 저장하고 성공 JSON을 돌려주며 실패 시 400 응답으로 사용자에게 수정 안내를 보여준다.

카테고리

프론트엔드·UI

난이도

basic

태그

Next.js · RouteHandler