При работе с крупными выборками данные в API Нейро42 возвращаются постранично.
Это позволяет быстрее обрабатывать ответы и снижает нагрузку на систему.
По умолчанию размер страницы — 100 записей, однако вы можете изменить это значение.
Максимальный допустимый лимит — 250 элементов за запрос.
Если результат содержит больше одной страницы, в ответе появится поле nextCursor — маркер, который используется для получения следующей порции данных.
Пример: загрузка активных агентов порциями по 150
- Запрашиваем первую страницу
curl -X ‘GET’ \
‘<your-cloud-instance>/api/v<version>/agents?active=true&limit=150’ \
-H ‘accept: application/json’ \
-H ‘X-NEURO42-API-KEY: <your-api-key>’
Пример ответа
Ответ приходит в формате JSON и содержит саму выборку плюс nextCursor, если данные не закончились:
{
«data»: [
{
// данные по каждому агенту
}
],
«nextCursor»: «MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA»
}
- Запрашиваем следующую страницу
Используем значение nextCursor и передаем его параметром cursor.
curl -X ‘GET’ \
‘<your-cloud-instance>/api/v<version>/agents?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA’ \
-H ‘accept: application/json’