API para integração

Versão 1 · somente leitura · disponível no plano Empresarial

Autenticação

Crie uma chave em Área do cliente → Minha conta → API para integração. Envie a chave em todas as chamadas:

Authorization: Bearer uai_SUA_CHAVE

A chave aparece uma única vez. Guarde em local seguro e revogue se vazar. Limite: 120 chamadas por minuto por chave. Respostas em JSON, horários em UTC (ISO 8601).

Veículos

GET /api/v1/vehicles

Lista os veículos da conta com a última posição conhecida.

{ "data": [ { "id": "…", "plate": "ABC1D23", "brand": "Fiat", "model": "Strada", "nickname": null,
  "odometer_km": 15230.4, "driver": "João Silva", "last_seen_at": "2026-10-14T13:05:10Z",
  "speed": 42, "position": { "lat": -19.9196, "lng": -43.9386 } } ] }

Posições (histórico)

GET /api/v1/vehicles/{id}/positions?from=2026-10-14T00:00:00-03:00&to=2026-10-14T23:59:59-03:00

Até 7 dias por consulta e 10.000 pontos (o campo truncated indica se há mais). Sem from/to, retorna as últimas 24 horas.

{ "data": [ { "time": "2026-10-14T12:00:05Z", "lat": -19.92, "lng": -43.94, "speed": 38, "course": 90, "ignition": true } ],
  "from": "…", "to": "…", "truncated": false }

Alertas

GET /api/v1/alerts?since=2026-10-14T00:00:00Z

Alertas desde a data informada (padrão: últimas 24 horas), até 1.000 por chamada. Tipos: speed, geofence_enter, geofence_exit, ignition_on, ignition_off, offline, online, parking_move, power_cut, panic, maintenance, off_hours.

Erros

401 chave ausente, inválida ou revogada · 403 plano sem API · 404 veículo não encontrado · 422 parâmetro inválido · 429 limite de chamadas.

Dúvidas: abra um chamado na área do cliente.