API 페이지네이션

기본 페이지 크기는 100 결과입니다. 페이지 크기 제한을 변경할 수 있습니다. 허용되는 최대 크기는 250입니다.

응답에 페이지가 하나 이상 포함된 경우 다음 페이지를 요청하는 데 사용할 수 있는 커서가 포함됩니다.

예를 들어, 활성 워크플로를 한 번에 150개 가져오고 싶다고 가정해 보겠습니다.

첫 번째 페이지를 가져옵니다:

# 자체 호스팅된 n8n 인스턴스용
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>'

# n8n 클라우드용
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": [
    // 응답에는 각 워크플로에 대한 객체가 포함됩니다
    {
      // 워크플로 데이터
    }
  ],
  "nextCursor": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA"
}

그런 다음 다음 페이지를 요청합니다:

# 자체 호스팅된 n8n 인스턴스용
curl -X 'GET' \
  '<N8N_HOST>:<N8N_PORT>/<N8N_PATH>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
  -H 'accept: application/json'

# n8n 클라우드용
curl -X 'GET' \
  '<your-cloud-instance>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
  -H 'accept: application/json'