Чтение каждой страницы, соблюдение ограничений скорости и безопасное восстановление после ошибок.
Ограничения скорости
Ограничения настраиваются. GET /v1/operations/capabilities сообщает о requestsPerMinute и authenticationRequestsPerMinutePerIp. После ошибки 429 соблюдайте правило «Повторить попытку» и подождите дольше, если ограничение скорости продолжается. Пакетное чтение принимает до 100 идентификаторов; Для отдельных конечных точек могут быть установлены меньшие ограничения на количество страниц или объем полезной нагрузки. (Retry-After)
Читайте каждую страницу
Используйте правило продолжения для вызываемой конечной точки, сохраняя те же фильтры. Списки могут изменяться во время чтения; используйте снимки, когда вам нужна согласованная копия.
Пагинация Продолжить с Остановить, когда Курсор Передать next как after. следующий — null. Смещение с nextOffset Передать nextOffset как offset. nextOffset равно null. Смещение с hasMore Увеличить смещение на количество возвращаемых элементов. hasMore равно false. Программное обеспечение Передать числовое значение next как after; перезапустить, если updatedAtUtc изменится. следующий — null. Лента событий Передать next как after. hasMore равно false. Обработка ошибок
Прочтите код ошибки, а также HTTP-статус. Если ответ содержит requestId, укажите его при обращении в службу поддержки.
HTTP-статус Что делать 400 Исправьте запрос. 401 Проверьте учетные данные или получите новый токен доступа. 403 Проверьте область действия, разрешения и включен ли доступ. 404 Ресурс может отсутствовать или выходить за пределы вашей области действия. 409 Перед принятием решения ознакомьтесь с кодом ошибки и текущим состоянием. 410 Срок действия снимка или курсора событий истек. Начните новую базовую линию. Если запись завершилась по таймауту
Таймаут или ошибка 503 не доказывают сбой действия. Для записей, возвращающих квитанции об операции, перед повторной попыткой найдите GET /v1/operations/by-key?idempotencyKey={key}. Для создания записей обслуживания используйте исходный Idempotency-Key и тело записи.