Disparado quando a lista de motoristas autorizados a operar o veículo muda — seja
porque um motorista foi adicionado ou removido da configuração, seja porque o status
global mudou (por exemplo, o dispositivo confirmou a propagação).
status | Significado |
|---|---|
inactive | Nenhum identificador autorizado configurado no dispositivo |
pending | Mudança em propagação — o app pediu uma adição/remoção que o dispositivo ainda não confirmou |
active | Pelo menos um identificador autorizado confirmado no dispositivo |
O
statusé derivado dos identificadores autorizados (chaveiro iButton, cartão
RFID), não dos motoristas. Um identificador autorizado sem motorista associado já leva
o status aactive— nesse caso você recebeactivecomdrivers_addedvazio.
Sobre drivers_added e drivers_removed
drivers_added e drivers_removed- Atenção ao
snake_case. São os únicos campos do payload fora do padrão
camelCase. Leia exatamentedrivers_addededrivers_removed. - São a diferença incremental desde o último evento enviado ao seu endpoint — não a
lista completa de autorizados. - Identificadores físicos sem motorista associado no momento do evento não aparecem
em nenhuma das duas listas. - Ambos podem vir vazios quando o evento foi disparado puramente por uma transição de
status(por exemplo,pending→active).
Disponibilidade. Apenas para frotas com hardware compatível.
Campos posicionais vêm como
null. Como emignition_lock_status_changed, os
campos de telemetria estão presentes no JSON com valornull. Em especial,
driverIdé semprenullaqui: os motoristas vêm emdrivers_addede
drivers_removed, nunca emdriverId.
Assine o tipo allow_list_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.