Пагинация
Все списочные endpoint’ы используют единые query-параметры:
page- 1-based номер страницы. По умолчанию1.pageSize- размер страницы, диапазон 1..200. По умолчанию50.
Пример:
curl -H "Authorization: Bearer $FW_KEY" \ "https://api.flowworker.ru/api/public/v1/tasks?projectId=123&page=2&pageSize=100"Ответ - массив объектов (без обёртки):
[ { "id": 9001, ... }, { "id": 9002, ... }]Когда страница последняя
Заголовок раздела «Когда страница последняя»Если возвращённый массив короче pageSize - больше страниц нет.
Стабильная сортировка
Заголовок раздела «Стабильная сортировка»Endpoint’ы сортируют по id ASC (для большинства ресурсов). Это значит, что новые записи появляются в конце последней страницы и не двигают предыдущие - безопасно последовательно перебирать.
Исключения:
GET /api/public/v1/events- сортировка поStartsAt.- Подзапросы с фильтрами времени могут сортироваться иначе - см. документацию endpoint’а.
Bulk-чтение
Заголовок раздела «Bulk-чтение»Для выгрузки большого объёма:
page = 1all_tasks = []while True: items = requests.get(f'...tasks?pageSize=200&page={page}', headers=H).json() if not items: break all_tasks.extend(items) page += 1Соблюдайте rate limits - между большими bulk-запросами можно вставлять time.sleep(0.1).