Leia todas as páginas, respeite os limites de taxa e recupere de erros em 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 da taxa se mantiver. As leituras em lote aceitam até 100 IDs; endpoints individuais podem ter limites de página ou de carga útil mais baixos. (Retry-After)
Ler todas as páginas
Utilize a regra de continuação para o endpoint que chamou, mantendo os mesmos filtros. As listas podem mudar à medida que as lê; utilize snapshots quando precisar de uma cópia consistente.
Paginação Continuar com Parar quando Cursor Passar next como after. O próximo é o null. Deslocar com nextOffset Passar nextOffset como offset. nextOffset é null. Deslocamento com hasMore Aumentar o deslocamento pelo número de itens devolvidos. hasMore é falso. Software Passar o valor numérico de next como after; reiniciar se updatedAtUtc mudar. O próximo é o null. Feed de eventos Passar next como after. hasMore é falso. Tratar erros
Ler o código de erro e o estado HTTP. Se a resposta incluir requestId, cite-a quando contactar o suporte.
Estado HTTP O que fazer 400 Corrija a solicitação. 401 Verifique as credenciais ou obtenha um novo token de acesso. 403 Verifique o âmbito, as permissões e se o acesso está ativado. 404 O recurso pode estar ausente ou fora do seu âmbito. 409 Leia o código de erro e o estado atual antes de decidir. 410 O cursor de instantâneo 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 devolvem recibos de operação, consulte GET e /v1/operations/by-key?idempotencyKey={key} antes de tentar novamente. Para a criação de manutenção, reutilize o Idempotency-Key e o corpo originais.