Перейти к содержимому

Пагинация

Все списочные 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’а.

Для выгрузки большого объёма:

page = 1
all_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).