API & IntegraçõesDisponível

Sua frota.
Conectada ao seu stack.

API REST + webhooks pra integrar o Chronyx ao que você já roda. ERP, BI, CRM, WMS, aplicativo próprio — tudo conversa em JSON. Sem ETL manual, sem planilha.

Ver documentação Falar com vendas

REST + Webhooks Auth por API key ou OAuth Rate limits generosos

terminal

$ curl https://api.chronyx.com.br/v1/positions/latest \
    -H "Authorization: Bearer cnyx_live_..."

{
  "device_id": "veh_8a3c",
  "device_name": "Cargas 04",
  "lat": -23.55052,
  "lng": -46.63331,
  "speed_kmh": 42,
  "timestamp": "2026-05-10T14:32:08Z"
}

+ Webhooks pra eventos em tempo real

O problema

Dados ricos.
Sistemas isolados.

A frota gera milhares de eventos por dia. Mas se eles ficam só no painel de rastreamento, são dados mortos. Quem cruza com pedido, NF, cliente, motorista — gera valor de verdade.

Planilha manual

Você exporta CSV, cola em Excel, conta paradas, calcula combustível. Erro humano e horas perdidas todo mês.

Dados em silo

Pedido tá no ERP, posição tá no rastreador, nota fiscal tá no SAT. Cliente liga, você abre 4 abas pra responder.

Reação tardia

Evento de pânico, motorista parou fora de cerca — quem avisa o atendimento? Hoje, ninguém. Quando descobre, é tarde.

Endpoints

Tudo que o painel mostra,
a API entrega.

GET/api/positions

Posições

Última posição ou histórico por veículo/data. Suporta paginação.

GET/api/devices

Dispositivos

Lista de veículos cadastrados, status online/offline, atributos.

GET/api/events

Eventos

Histórico de eventos (frenagem, cerca, SOS, alarme de IA, etc).

GET/api/geofences

Geocercas

Lista, cria, edita e remove cercas geográficas.

GET/api/drivers

Motoristas

Cadastro de motorista, vínculo com veículo, score.

POST/api/telemetry

Telemetria

Recebe eventos derivados (frenagem brusca, excesso vel, parada longa).

Webhooks

Não fica pulando
o endpoint.

Pedir posição a cada 30s é desperdício. Configure um webhook: a gente avisa quando algo acontece. Você reage, em vez de perguntar.

EVENTOS DISPARÁVEIS

position.update — nova posição GPS
device.online / device.offline
geofence.enter / geofence.exit
event.harsh_brake / acceleration / curve
event.overspeed
event.sos — botão de pânico
alarm.dsm / adas / bsd — IA da câmera
device.ignition_on / ignition_off

Webhook payload (exemplo)

POST https://seu-erp.com/webhooks/chronyx
Content-Type: application/json
X-Chronyx-Signature: sha256=...

{
  "event": "geofence.exit",
  "device_id": "veh_8a3c",
  "device_name": "Cargas 04",
  "geofence": {
    "id": "gf_depo_sp",
    "name": "Depósito SP"
  },
  "position": {
    "lat": -23.55052,
    "lng": -46.63331,
    "speed_kmh": 42,
    "timestamp": "2026-05-10T14:32:08Z"
  }
}

Na prática

Como integradores
usam hoje.

Buscar últimas posições da frota (curl)

curl https://api.chronyx.com.br/v1/positions/latest \
  -H "Authorization: Bearer cnyx_live_..."

# Response
[
  {
    "device_id": "veh_8a3c",
    "lat": -23.55,
    "lng": -46.63,
    "speed_kmh": 42,
    "timestamp": "2026-05-10T14:32:08Z"
  },
  ...
]

Listar eventos de um veículo (curl)

curl 'https://api.chronyx.com.br/v1/events?\
device_id=veh_8a3c&from=2026-05-10&type=harsh_brake' \
  -H "Authorization: Bearer cnyx_live_..."

# Response
[
  {
    "id": "evt_71f",
    "type": "harsh_brake",
    "severity": "high",
    "timestamp": "2026-05-10T14:32:08Z",
    "delta_kmh": -23
  }
]

Segurança

Auth simples,
auth corporativa.

API Key

Pra integração rápida. Token bearer, escopos por chave, rotação fácil.

OAuth 2.0

Pra integradores com múltiplos clientes. Flows authorization_code + client_credentials.

Rate limits claros

Padrão 60 req/min por chave. Plano corporativo desbloqueia 600+. Sem surpresa de cobrança.

Webhook signing

Cada webhook vem assinado com HMAC-SHA256 — você confirma que veio da gente, não de impostor.

Idempotência

Todo POST aceita Idempotency-Key. Reentrega de webhook não duplica nada do lado do cliente.

SDKs no roadmap

Node.js e Python no Q3/2026. Por enquanto, a API é REST puro — fala com qualquer linguagem.

Casos de uso

Onde os clientes
estão plugando hoje?

ERP

TOTVS Protheus
SAP
Sankhya
Bling

BI & analytics

Power BI
Metabase
Looker
Tableau

WMS / E-commerce

Status de entrega
Tracking pro cliente
Confirmação automática

Roteirização

Sincronizar paradas
Importar plano de rota
Cross-check execução

Setup

Da chave ao primeiro webhook em 1h.

Gera a chave

Painel → Configurações → API. Cria chave, define escopos (read-only? full?).

Lê a doc

Endpoints, schemas, códigos de erro, paginação. OpenAPI 3.1 disponível.

Liga o webhook

Aponta a URL do seu sistema. Eventos chegam em JSON assinado.

Demonstração

Pronto pra ver
na sua frota?

Acesso à documentação completa (OpenAPI 3.1)
Chave de teste em ambiente sandbox
Suporte direto com o time de engenharia
Sem custo em todos os planos pagos

Acesso à API

Resposta em até 1 dia útil.

Sua frota.Conectada ao seu stack.

Dados ricos.Sistemas isolados.