Leia todas as páginas, respeite os limites de taxa e recupere-se de erros com segurança.
Limites de taxa
Os limites são configuráveis. GET e /v1/operations/capabilities reportam requestsPerMinute e authenticationRequestsPerMinutePerIp. Após um erro 429, respeite a opção "Tentar novamente após" e aguarde mais tempo se a limitação de taxa continuar. Leituras em lote aceitam até 100 IDs; endpoints individuais podem ter limites de página ou de carga útil menores. (Retry-After)
Leia cada página
Use a regra de continuação para o endpoint que você chamou, mantendo os mesmos filtros. As listas podem mudar enquanto você as lê; use snapshots quando precisar de uma cópia consistente.
Paginação Continuar com Parar quando Cursor Passar next como after. O próximo é null. Deslocar com nextOffset Passar nextOffset como offset. nextOffset é null. Deslocamento com hasMore Aumentar o deslocamento pelo número de itens retornados. hasMore é falso. Software Passar o valor numérico de next como after; reiniciar se updatedAtUtc mudar. O próximo é null. Feed de eventos Passar next como after. hasMore é falso. Tratar erros
Ler o código de erro e o status HTTP. Se a resposta incluir requestId, cite-a ao entrar em contato com o suporte.
Status HTTP O que fazer 400 Corrija a solicitação. 401 Verifique as credenciais ou obtenha um novo token de acesso. 403 Verifique o escopo, as permissões e se o acesso está habilitado. 404 O recurso pode estar ausente ou fora do seu escopo. 409 Leia o código de erro e o estado atual antes de decidir. 410 O cursor de snapshot ou evento expirou. Inicie uma nova linha de base. Se uma gravação expirar
Um tempo limite ou erro 503 não comprova que a ação falhou. Para gravações que retornam recibos de operação, consulte GET e /v1/operations/by-key?idempotencyKey={key} antes de tentar novamente. Para criação de manutenção, reutilize o Idempotency-Key e o corpo originais.