Posição periódica do veículo com a ignição ligada.
Janelamento de 3 minutos
A Cobli não entrega cada ping GPS. Aplica-se uma janela de 3 minutos por
dispositivo:
- O primeiro evento é entregue assim que o dispositivo transmite uma posição válida
no estado de ignição atual. - Depois de uma entrega, os pings seguintes são descartados até completar 3
minutos desde o último envio. - Passados os 3 minutos, o próximo ping disponível é entregue e o ciclo recomeça.
- Uma mudança de estado da ignição força o envio imediato, sem esperar o ciclo —
é o que garante que a transição entrepositioneposition_sleepapareça no fluxo.
Na prática, 100 veículos em movimento contínuo geram no máximo ~33 eventos por
minuto (100 ÷ 3), não centenas de pings.
Se a sua aplicação precisa de rastreamento contínuo, ping a ping, o webhook não
é o canal correto — useGET /public/v1/paths. Webhook é otimizado para eventos
discretos.
Assine o tipo position para receber este evento.
A Cobli envia este evento como POST application/json para a URL cadastrada na
assinatura, assinado em X-Cobli-Signature. Responda 2xx em até 5 segundos e
deduplique por eventId.
Evento aceito. Responda 2xx em até 5 segundos — enfileire e processe de forma assíncrona se o seu processamento for demorado. Nenhuma retentativa é feita.
Evento rejeitado de forma permanente — use para assinatura HMAC inválida ou payload malformado. A Cobli trata 4xx como falha definitiva e não retenta, com duas exceções: 429 (ver abaixo) e 401 em assinaturas com Bearer auth habilitado, em que a Cobli renova o token e retenta. Não devolva 4xx para um eventType que você não espera: ignore-o e responda 2xx.
Falha temporária no seu lado. A Cobli faz até 5 tentativas no total, com backoff exponencial entre elas — 2 s → 4 s → 8 s → 15 s —, jitter de ±20 % e teto de 15 s por intervalo. O mesmo vale para timeout: sem resposta em 5 segundos.