Polling de pedidos
Consulte os eventos de pedidos quando sua aplicação não puder receber webhooks ou precisar reconciliar alterações. Para recebimento em tempo real, prefira webhooks.
Como consultar
GET /v1/orders/polling
Envie o access token no header Authorization: Bearer <accessToken> com permissão de leitura de pedidos. A resposta traz eventos, não os dados completos do pedido.
Filtros da consulta
| Parâmetro | Uso |
|---|---|
updatedSince | Filtra eventos atualizados desde uma data ISO 8601. Se informado, deve estar dentro das últimas 24 horas. |
events | Seleciona um ou mais tipos de evento. |
Os parâmetros são opcionais. A janela de eventos disponíveis continua sendo de 8 horas, mesmo que updatedSince aceite uma data nas últimas 24 horas.
Tratar os eventos
Use orderId para localizar o pedido no seu sistema e event para identificar a alteração. Reaproveite o tratamento dos webhooks e aceite eventos repetidos sem duplicar operações.
Uma mudança de entrega pode ser aplicada pelo orderStatusDelivery recebido. Busque o detalhe somente quando precisar de dados que o evento não traz.
Recuperar após uma interrupção
Consulte o polling para reconciliar as últimas 8 horas e use updatedSince para delimitar o período disponível. Para intervalos maiores, consulte a listagem de pedidos com filtro de período.
Respeitar os limites
Cada consulta conta nos limites da API. Ao receber 429, aguarde o tempo indicado em Retry-After antes de tentar novamente.
- Referência da rota de polling — Parâmetros, exemplos de requisição, resposta e erros.
- Limites de requisição
- Webhook desativado