Skip to content

API pagination#

ขนาดหน้าเริ่มต้นคือ 100 ผลลัพธ์ คุณสามารถเปลี่ยนขีดจำกัดขนาดหน้าได้ ขนาดสูงสุดที่อนุญาตคือ 250

เมื่อ response มีมากกว่าหนึ่งหน้า จะมี cursor ซึ่งคุณสามารถใช้เพื่อขอหน้าถัดไปได้

ตัวอย่างเช่น สมมติว่าคุณต้องการดึงข้อมูล workflows ที่ active ทั้งหมด ครั้งละ 150 รายการ

รับหน้าแรก:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# สำหรับ n8n instance แบบ self-hosted
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>'

response อยู่ในรูปแบบ JSON และมีค่า nextCursor นี่คือตัวอย่าง response

1
2
3
4
5
6
7
8
9
{
  "data": [
    // The response contains an object for each workflow
    {
      // Workflow data
    }
  ],
  "nextCursor": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA"
}

จากนั้น หากต้องการขอหน้าถัดไป:

1
2
3
4
5
6
7
8
9
# สำหรับ n8n instance แบบ self-hosted
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'