Skip to content

API 分页#

默认每页返回 100 条结果。您可以修改分页大小限制，最大允许值为 250。

当响应包含多页数据时，会返回一个游标(cursor)，您可以用它来请求后续页面。

例如，假设您想获取所有活跃的工作流，每次获取 150 条。

获取第一页：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# 对于自托管的 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 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 值。以下是示例响应：

1
2
3
4
5
6
7
8
9
{
  "data": [
    // 响应中包含每个工作流的对象
    {
      // 工作流数据
    }
  ],
  "nextCursor": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA"
}

然后请求下一页：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# 对于自托管的 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 Cloud
curl -X 'GET' \
  '<your-cloud-instance>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
  -H 'accept: application/json'