Endpoints REST, schema de webhooks e exemplos. Pra integradores, parceiros e times técnicos.
Painel → Configurações → API. Crie chave, escolha escopo, copie.
curl com Bearer + endpoint /v1/positions/latest. Resposta em JSON.
Configure URL no painel, eventos chegam assinados via HMAC.
Authorization: Bearer cnyx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
# OAuth 2.0 (opcional, pra integradores multi-cliente)
POST /v1/oauth/token
{ "grant_type": "client_credentials",
"client_id": "...", "client_secret": "..." }Base URL: https://api.chronyx.com.br
| GET | /v1/devices | Lista de dispositivos Paginado, com filtro por grupo e status. |
| GET | /v1/devices/{id} | Detalhes de dispositivo Atributos, posição atual, motorista vinculado. |
| POST | /v1/devices | Cadastrar dispositivo Cria novo dispositivo (IMEI + modelo). |
| PATCH | /v1/devices/{id} | Atualizar dispositivo Edita atributos (nome, motorista, grupo). |
| GET | /v1/positions/latest | Últimas posições Última posição de cada dispositivo da frota. |
| GET | /v1/positions | Histórico de posições Filtros: device_id, from, to. Paginado. |
| GET | /v1/events | Lista de eventos Frenagem, aceleração, curva, excesso, cerca, SOS. |
| GET | /v1/events/{id} | Detalhe de evento Inclui posição, contexto e mídia se houver. |
| GET | /v1/geofences | Lista de cercas Polígonos e círculos cadastrados. |
| POST | /v1/geofences | Criar cerca GeoJSON ou centro + raio. |
| DELETE | /v1/geofences/{id} | Remover cerca Apaga permanentemente. |
| GET | /v1/drivers | Lista de motoristas Inclui score atual e vínculo de veículo. |
| GET | /v1/drivers/{id}/score | Score histórico Score por dia, com breakdown por tipo de evento. |
Cada webhook é assinado com HMAC-SHA256. Verifique a assinatura no header X-Chronyx-Signature.
position.updatedevice.onlinedevice.offlinegeofence.entergeofence.exitevent.harsh_brakeevent.accelerationevent.curveevent.overspeedevent.sosevent.ignition_onevent.ignition_offalarm.dsm.fatiguealarm.dsm.phonealarm.adas.collisionalarm.adas.lane_departurealarm.bsdPOST https://seu-erp.com/webhooks/chronyx
Content-Type: application/json
X-Chronyx-Signature: sha256=abcd1234...
X-Chronyx-Timestamp: 1715346728
{
"event": "event.harsh_brake",
"event_id": "evt_71f",
"device_id": "veh_8a3c",
"device_name": "Cargas 04",
"driver_id": "drv_22",
"severity": "high",
"delta_kmh": -23,
"position": {
"lat": -23.55052,
"lng": -46.63331,
"speed_kmh": 42,
"timestamp": "2026-05-10T14:32:08Z"
}
}| Plano | Requests/min | Burst | Webhooks/s |
|---|---|---|---|
| Free | 60 | 120 | 10 |
| Pro | 600 | 1.200 | 100 |
| Enterprise | sob acordo | sob acordo | sob acordo |
OpenAPI 3.1 + Postman collection sob solicitação.