상품 목록 페이지네이션 API

Next.js 의 GET Route Handler 로 상품 목록을 한 번에 다 주지 않고 한 페이지에 10개씩 끊어서 주는 API 를 완성하는 문제입니다. ?page=N 요청을 받아 그 페이지의 상품과 함께 현재 페이지·총 페이지 개수·전체 개수·이 페이지 항목을 JSON 으로 돌려주고, 페이지를 안 줬을 때 1페이지로 보는 기본 동작까지 다룹니다.

페이지네이션은 항목이 많은 목록을 한꺼번에 다 보내는 대신 한 페이지 분량씩 나눠 응답하는 방식입니다. 응답에는 현재 페이지뿐 아니라 전체 개수와 총 페이지 개수 같은 메타 정보를 함께 담아, 호출하는 쪽이 다음·이전 페이지를 알 수 있게 합니다. 이 문제는 ?page=N 요청에 그 페이지의 항목과 현재 페이지·총 페이지 개수·전체 개수를 담아 돌려주고, page 를 안 줬을 때는 1페이지로 보는 기본 동작까지 완성한 뒤, 일반적인 ?page=N 요청이 알맞은 항목과 메타 정보를 돌려주는지 실제 코드로 확인합니다.

Next.js 에서 페이지네이션 API 는 어디에 만드나요?

App Router 에서는 app/api/.../route.ts 의 GET Route Handler 에 둡니다. 요청의 쿼리스트링(?page=N)을 읽어 해당 페이지 데이터를 JSON 으로 돌려줍니다.

페이지네이션 응답에는 무엇을 담아야 하나요?

이 문제 기준으로는 현재 페이지, 총 페이지 개수, 전체 개수, 이 페이지의 항목을 함께 담습니다. 메타 정보가 있어야 호출하는 쪽이 페이지를 이동할 수 있습니다.

페이지네이션 동작은 어떻게 검증하나요?

일반적인 ?page=N 요청을 보내 그 페이지의 items 와 현재 페이지·총 페이지 개수·전체 개수가 모두 맞는지, 그리고 page 를 안 줬을 때 1페이지로 응답하는지 확인합니다.