HTTP Request node는 페이지네이션을 지원합니다. 이 페이지에서는 HTTP node 변수 사용을 포함한 몇 가지 예제 구성을 제공합니다.

노드에 대한 자세한 내용은 HTTP Request를 참고하세요.

페이지네이션 활성화하기#

HTTP Request node에서 Add Option > Pagination을 선택합니다.

$response를 사용해 응답의 URL로 다음 페이지 가져오기#

API가 응답에 다음 페이지의 URL을 반환하는 경우:

1. Pagination Mode를 Response Contains Next URL로 설정합니다. n8n이 이 옵션에 대한 매개변수를 표시합니다.
2. Next URL에서 표현식¹을 사용해 URL을 설정합니다. 정확한 표현식은 API가 반환하는 데이터에 따라 다릅니다. 예를 들어 API가 응답 본문에 next-page라는 매개변수를 포함한다면:

   {{ $response.body["next-page"] }}
   

$pageCount를 사용해 번호로 다음 페이지 가져오기#

사용 중인 API가 번호로 특정 페이지를 지정하는 기능을 지원하는 경우:

1. Pagination Mode를 Update a Parameter in Each Request로 설정합니다.
2. Type을 Query로 설정합니다.
3. 쿼리 매개변수의 Name을 입력합니다. 이는 사용 중인 API에 따라 다르며 보통 해당 API 문서에 설명되어 있습니다. 예를 들어 일부 API는 페이지를 설정하기 위해 page라는 이름의 쿼리 매개변수를 사용합니다. 이 경우 Name은 page가 됩니다.
4. Value 위에 마우스를 올리고 Expression을 켭니다.
5. {{ $pageCount + 1 }}을 입력합니다.

$pageCount는 HTTP Request node가 가져온 페이지 수입니다. 0부터 시작합니다. 대부분의 API 페이지네이션은 1부터 세므로(첫 페이지가 1페이지), $pageCount에 +1을 더하면 노드가 첫 번째 루프에서 1페이지를, 두 번째 루프에서 2페이지를 가져오는 식으로 동작합니다.

본문 매개변수를 통해 페이지네이션 탐색하기#

사용 중인 API가 본문 매개변수를 통한 페이지네이션을 허용하는 경우:

1. HTTP Request Method를 POST로 설정합니다.
2. Pagination Mode를 Update a Parameter in Each Request로 설정합니다.
3. Type 매개변수에서 Body를 선택합니다.
4. 본문 매개변수의 Name을 입력합니다. 이는 사용 중인 API에 따라 다릅니다. page는 흔히 쓰이는 키 이름입니다.
5. Value 위에 마우스를 올리고 Expression을 켭니다.
6. {{ $pageCount + 1 }}을 입력합니다.

쿼리에서 페이지 크기 설정하기#

사용 중인 API가 쿼리에서 페이지 크기 선택을 지원하는 경우:

1. 메인 노드 매개변수(노드를 처음 열었을 때 보이는 매개변수이며, 옵션 내부의 설정이 아닙니다)에서 Send Query Parameters를 선택합니다.
2. 쿼리 매개변수의 Name을 입력합니다. 이는 사용 중인 API에 따라 다릅니다. 예를 들어 많은 API가 페이지 크기를 설정하기 위해 limit이라는 이름의 쿼리 매개변수를 사용합니다. 이 경우 Name은 limit이 됩니다.
3. Value에 페이지 크기를 입력합니다.

Footnotes

1. n8n에서 표현식을 사용하면 JavaScript 코드를 실행해 노드 매개변수를 동적으로 채울 수 있습니다. 정적인 값을 제공하는 대신, n8n 표현식 구문을 사용해 이전 노드나 다른 워크플로, 또는 n8n 환경의 데이터를 활용하여 값을 정의할 수 있습니다. ↩