fast_acceleration — Aceleração brusca detectada pela câmera

Disparado quando a câmera integrada Cobli detecta aceleração brusca.

Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o
eventType identifica o comportamento detectado.

Disponibilidade. Apenas para frotas com dispositivos de câmera integrada
Cobli, e a oferta de cada tipo depende do modelo instalado.

rpm e fuelLevel nunca estão presentes: a câmera não acessa o barramento
CAN. odometer aparece quando há odômetro inicial cadastrado no veículo.


Assine o tipo fast_acceleration 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.

Payload

Envelope do evento fast_acceleration.

Envelope comum a todos os eventos de webhook da Cobli. O corpo da requisição POST é sempre este objeto — o que varia entre os tipos é o conteúdo de eventData.

uuid
required

Identificador determinístico do evento, derivado de fleetId + signatureId + deviceId + eventType + eventTime. Nos eventos de rota e parada o identificador do recurso (routeId ou activityId) também entra na derivação, para que dois recursos encerrados no mesmo milissegundo não colidam.

O mesmo evento sempre produz o mesmo eventId — em retentativas, em retransmissões e na recuperação via GET /public/v2/events. Use como chave de idempotência.

date-time
required

Momento em que o evento ocorreu no dispositivo, em ISO 8601 UTC.

string
enum
required

Tipo do evento.

Allowed:
eventData
object
required

Não acrescenta campos aos comuns. rpm e fuelLevel nunca estão presentes — a câmera não tem acesso ao barramento CAN. odometer aparece quando há odômetro inicial cadastrado no veículo.

Responses
200

Evento aceito. Responda 2xx em até 5 segundos — enfileire e processe de forma assíncrona se o seu processamento for demorado. Nenhuma retentativa é feita.

400

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.

500

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.

LoadingLoading…