Disparado quando o status global da trava de ignição do veículo muda.
O status é derivado da combinação entre o valor desejado (configurado no app) e o
valor reportado pelo dispositivo, e esconde essa distinção de você:
status | Significado |
|---|---|
inactive | Trava desligada — o dispositivo reportou a trava desativada e nada está pendente |
pending | Mudança em propagação — o app pediu uma configuração que o dispositivo ainda não confirmou (ou vice-versa) |
active | Trava ligada — o dispositivo confirmou que a trava está ativa |
Disponibilidade. Apenas para frotas com hardware compatível. Frotas sem trava de
ignição instalada não recebem este evento.
Campos posicionais vêm como
null, não ausentes. Este evento descreve o estado
de uma configuração, não uma telemetria:latitude,longitude,heading,
odometer,driverId,cobliIde os demais campos de telemetria estão presentes
no JSON com valornull.speedInKmhnão aparece.licensePlateé incluído
quando o veículo tem placa cadastrada e omitido caso contrário.networkSignal
nunca aparece neste evento.
Assine o tipo ignition_lock_status_changed 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.