SVILUPPATORI

Costruisci su Runic.

API REST e webhook sugli stessi dati di posizione che vedi nell’app. Leggi le posizioni, iscriviti agli eventi e porta il tracking dentro il prodotto che già usi.

Leggi la documentazione Ottieni le API key

developers.runic.io · support@runic.io

La tua prima richiesta

Autenticati con un bearer token e leggi l’ultima posizione di un dispositivo.

curl https://api.runic.io/v1/assets/ast_8f21/position \
  -H "Authorization: Bearer rk_live_..."

{
  "asset_id": "ast_8f21",
  "recorded_at": "2026-08-10T09:41:12Z",
  "lat": 45.4642,
  "lon": 9.1900,
  "speed_kph": 54,
  "heading": 118,
  "ignition": true
}

Cosa offre l’API

Posizioni

Ultima posizione e storico per ogni dispositivo, con velocità e direzione.

Viaggi

Partenza, arrivo, distanza e durata già strutturati, non punti grezzi.

Asset e gruppi

Crea, rinomina e organizza gli asset via codice.

Geofence

Definisci zone e ricevi eventi di ingresso e uscita.

Webhook

Callback HTTPS firmati, con retry e replay.

Sandbox

Ambiente di test completo con dispositivi simulati prima del go-live.

Eventi disponibili

Ogni evento arriva come payload JSON firmato, con retry automatici per 24 ore.

Librerie e strumenti

Client ufficiali per JavaScript, Python e PHP, schema OpenAPI e collection Postman.

asset.movedSi attiva quando un asset fermo inizia a muoversi.
trip.completedSi attiva alla fine di un viaggio, con distanza e durata.
geofence.enteredSi attiva quando un asset entra in una zona definita.
device.offlineSi attiva quando un dispositivo smette di trasmettere.