Pagination

To handle large datasets efficiently, Zluri APIs return paginated responses. This allows you to retrieve data in smaller chunks, improving performance and reliability.

How Pagination Works

  • page: Indicates the page number you want to retrieve (starts at 1)
  • page_size: Number of records to return per page (default: 50, max: API Specific)

Each paginated response also includes metadata to help with navigation:

{
  "count": 150,
  "page": 2,
  "page_size": 50,
  "items": [...]
}

Reuploading Pages

If you encounter an error while uploading a page, you can re-upload the same page number during an active sync. The system will automatically overwrite the previously uploaded data for that page. This ensures that you can correct mistakes without needing to restart the entire sync.

Example Request

curl --request POST \
     --url https://api-ext.zluri.com/v2/integrations-sync/syncs/sync_id/snapshot-data \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "entity_name": "users",
  "page_number": 3
}
'

This request will return the second page, with 50 items per page.

Note: Use the count field in the response to determine how many pages of data are available.