Public API

Постраничный обход и соблюдение лимитов

Списки отдаются страницами по курсору, а не по офсету, поэтому идите за курсором из ответа, а не вычисляйте его сами. Следите за заголовками rate limit и используйте updatedSince для опроса вместо повторного чтения всего.

Проверено 20 августа 2026 г.

Шаги

1. Идите за курсором из каждого ответа, пока он не перестанет возвращаться. Не конструируйте курсоры сами.
2. Держите разумный размер страницы: большие страницы означают меньше запросов, но более медленных.
3. Опрашивайте через updatedSince, а не обходите всю коллекцию по расписанию.
4. Читайте заголовки rate limit и замедляйтесь до отказа, а не после него.
5. Сохраняйте requestId всего, что упало, — для поддержки.

Как проверить результат

Полный обход коллекции возвращает каждый объект один раз, а повторный опрос читает только изменившееся.

Что обычно идёт не так

• Построение страниц по офсету, который смещается, когда данные меняются.
• Повторное чтение всего каждую минуту и выход за лимит.
• Использование устаревшего курсора и ошибка invalid cursor.