O que consultar
Planeje seu orçamento de consultas
Cada chave tem 120 requisições a cada 60 segundos, compartilhadas por todas as operações (veja Limites de uso). O orçamento de uma integração poderia ficar assim:
Deixe margem para novas tentativas e para consultas manuais com a mesma chave, ou dê a cada processo sua própria chave.
Boas práticas
- Filtre por status para ler apenas os pedidos ou entregas que você está esperando, em vez de varrer tudo.
- Lembre-se do que você viu. Guarde cada
orderIdcom seu últimostatuseversion, e cada atendimento com seu últimoupdatedAt. Aja apenas quando mudarem. - Conte com ver uma mudança mais de uma vez, ou com atraso. Faça o processamento idempotente: tratar o mesmo status duas vezes não pode causar problemas.
- Leia as listas inteiras com
limit=200e siganextCursoraté o fim (veja Paginação). - Não sobreponha execuções. Comece a próxima consulta apenas quando a anterior terminar.
- Espere diante de um
429. Aguarde oRetry-Afterantes da próxima requisição.