API 分页#

默认每页大小为 100 条结果。你可以更改每页的数量限制，最大允许值为 250。

当响应包含多个页面时，会返回一个游标（cursor），你可以使用该游标来请求下一页内容。

例如，假设你想每次获取 150 个激活状态的工作流（workflows）。

获取第一页：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

| ```

对于自托管的 n8n 实例

curl'GET'
'<N8N_HOST>:<N8N_PORT>/<N8N_PATH>/api/v/workflows?active=true&limit=150'
'accept: application/json'
'X-N8N-API-KEY: '

对于 n8n Cloud

curl'GET'
'/api/v/workflows?active=true&limit=150'
'accept: application/json'
'X-N8N-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

| ```

对于自托管的 n8n 实例

curl'GET'
'<N8N_HOST>:<N8N_PORT>/<N8N_PATH>/api/v/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA'
'accept: application/json'

对于 n8n Cloud

curl'GET'
'/api/v/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA'
'accept: application/json'

---|---