Пагинация

Единого конверта пагинации в API нет — смотрите схему ответа конкретной операции в справочнике API.

Два типовых случая:

Плоские спискиСкопировать ссылку на раздел

Большинство списочных операций (например, GET /api/v1/tasks) возвращают массив целиком; объём ограничен областью видимости команды и фильтрами запроса:

GET /api/v1/tasks?status=inProgress HTTP/1.1

[{ "id": "8d2c0e7a-5b1f-4c3e-9a6d-2f4b7c1e9a30", "title": "Проверить договор" }]

Пагинация с курсоромСкопировать ссылку на раздел

Журнальные данные отдаются страницами с курсором — например, журнал аудита безопасности:

GET /api/v1/security/audit/me?limit=50 HTTP/1.1

{ "events": [...], "nextCursor": "eyJpZCI6..." }

Передавайте nextCursor в параметре cursor следующего запроса; значение null означает конец выборки. Точные имена полей конверта указаны в схеме каждой операции.