پرش به محتویات

صفحه‌بندی API#

اندازه صفحه پیش‌فرض 100 نتیجه است. می‌توانید محدودیت اندازه صفحه را تغییر دهید. حداکثر اندازه مجاز 250 است.

هنگامی که یک پاسخ شامل بیش از یک صفحه است، شامل یک نشانگر است که می‌توانید از آن برای درخواست صفحات بعدی استفاده کنید.

برای مثال، فرض کنید می‌خواهید تمام ورکفلوها فعال را، 150 مورد در هر بار، دریافت کنید.

صفحه اول را دریافت کنید:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# برای یک اینستنس n98n خود میزبان
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>'

# برای n98n 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
# برای یک اینستنس n98n خود میزبان
curl -X 'GET' \
  '<N8N_HOST>:<N8N_PORT>/<N8N_PATH>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
  -H 'accept: application/json'

# برای n98n Cloud
curl -X 'GET' \
  '<your-cloud-instance>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
  -H 'accept: application/json'