Next.js API 라우팅

리퀘스트 핸들러 함수

예를 들어서 /api/short-links로 들어오는 리퀘스트를 처리하려면 /pages/api/short-links.js 또는 /pages/api/short-links/index.js 경로로 파일을 만들고 아래처럼 함수를 default export하면 됩니다.

export default async function handler(req, res) {
  ...
}

리퀘스트 객체

프로퍼티	타입	   설명
method	  문자열	 리퀘스트로 들어온 HTTP 메소드 값
query	  객체	  쿼리 스트링이나 Next.js에서 사용하는 Params 값이 들어 
                   있는 객체
body	  자유로움	리퀘스트의 바디 값
cookie	  객체	 리퀘스트의 쿠키가 키/밸류로 들어 있는 객체

리스폰스 객체

함수 체이닝 방식으로 사용하기 때문에, res.status(201).send()처럼 함수를 이어서 사용할 수 있습니다.

프로퍼티	  타입	설명
status()	함수	  리스폰스로 보낼 HTTP 상태 코드를 지정
send()	    함수	  리스폰스로 보낼 바디를 전달

참고 자료

이것 말고도 다양한 프로퍼티와 메소드가 있는데요, 궁금하신 분들은 아래 링크에 있는 공식 문서를 참고해 보세요.

API Routes - Request Helpers
API Routes - Response Helpers