API 페이지네이션
n8n v2.29기본 페이지 크기는 100개 결과입니다. 응답에 두 개 이상의 페이지가 포함된 경우, 다음 페이지를 요청하는 데 사용할 수 있는 커서(cursor)가 포함됩니다. 예를 들어 활성 워크플로를 한 번에 150개씩 모두 가져오고 싶다고 가정해 보겠습니다.
기본 페이지 크기는 100개 결과입니다. 페이지 크기 제한을 변경할 수 있습니다. 허용되는 최대 크기는 250입니다.
응답에 두 개 이상의 페이지가 포함된 경우, 다음 페이지를 요청하는 데 사용할 수 있는 커서(cursor)가 포함됩니다.
예를 들어 활성 워크플로를 한 번에 150개씩 모두 가져오고 싶다고 가정해 보겠습니다.
첫 번째 페이지를 가져옵니다:
# For a self-hosted n8n instance
curl -X 'GET' \
'<N8N_HOST>:<N8N_PORT>/<N8N_PATH>/api/v<version-number>/workflows?active=true&limit=150' \
-H 'accept: application/json' \
-H 'X-N8N-API-KEY: <your-api-key>'
# For n8n Cloud
curl -X 'GET' \
'<your-cloud-instance>/api/v<version-number>/workflows?active=true&limit=150' \
-H 'accept: application/json' \
-H 'X-N8N-API-KEY: <your-api-key>'
응답은 JSON 형식이며 nextCursor 값을 포함합니다. 다음은 예시 응답입니다.
{
"data": [
// The response contains an object for each workflow
{
// Workflow data
}
],
"nextCursor": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA"
}
그런 다음 다음 페이지를 요청하려면:
# For a self-hosted n8n instance
curl -X 'GET' \
'<N8N_HOST>:<N8N_PORT>/<N8N_PATH>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
-H 'accept: application/json'
# For n8n Cloud
curl -X 'GET' \
'<your-cloud-instance>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
-H 'accept: application/json'