Public API

Посторінковий обхід і дотримання лімітів

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

Перевірено 20 серпня 2026 р.

Кроки

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

Як перевірити результат

Повний обхід колекції повертає кожен об’єкт один раз, а повторне опитування читає лише те, що змінилося.

Що зазвичай іде не так

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