Прочитайте кожну сторінку, дотримуйтесь обмежень швидкості та безпечно відновлюйтесь після помилок.
Обмеження швидкості
Обмеження налаштовуються. GET /v1/operations/capabilities повідомляє requestsPerMinute та authenticationRequestsPerMinutePerIp. Після 429 виконайте Retry-After та зачекайте довше, якщо обмеження продовжується. Пакетне читання приймає до 100 ідентифікаторів; окремі кінцеві точки можуть мати менші обмеження сторінок або корисного навантаження.
Читайте кожну сторінку
Використовуйте правило продовження для викликаної кінцевої точки, зберігаючи ті самі фільтри. Списки можуть змінюватися під час їх читання; використовуйте знімки, коли вам потрібна узгоджена копія.
Пагінація Продовжити з Зупинити, коли Курсор Передати next як after. наступний - null. Зсув з nextOffset Передати nextOffset як offset. nextOffset – це null. Зсув на hasMore Збільшити зсув на кількість повернутих елементів. hasMore – це хибність. Програмне забезпечення Передати числове значення next як after; перезапустити, якщо updatedAtUtc зміниться. наступний - null. Стрічка подій Передати next як after. hasMore – це хибність. Обробляти помилки
Зчитати код помилки, а також стан HTTP. Якщо відповідь містить requestId, вкажіть його під час звернення до служби підтримки.
Стан HTTP Що робити 400 Виправити запит. 401 Перевірити облікові дані або отримати новий токен доступу. 403 Перевірити область дії, дозволи та чи ввімкнено доступ. 404 Ресурс може бути відсутнім або поза вашою областю дії. 409 Перш ніж приймати рішення, прочитайте код помилки та поточний стан. 410 Термін дії знімка або курсора події минув. Почніть нову базову лінію. Якщо час очікування запису вичерпано
Тайм-аут або 503 не доводять, що дія не вдалася. Для записів, які повертають підтвердження операції, знайдіть GET /v1/operations/by-key?idempotencyKey={key} перед повторною спробою. Для створення технічного обслуговування повторно використовуйте оригінальний Idempotency-Key та тіло.