API dello storico della flotta Online
Traccia GPS registrata dei tuoi veicoli: ogni punto di posizione memorizzato in una finestra temporale, in ordine cronologico, con velocità, direzione e precisione. Filtra per un singolo veicolo o prendi l'intera flotta. La finestra è limitata a 31 giorni per chiamata e 5000 punti per risposta — scorri periodi più lunghi spostando ?from= sull'ultimo timestamp restituito.
GET https://nakordoni.eu/api/v2/data/fleet/history
— classe di quota: heavy
| Parametro | Descrizione |
|---|---|
vehicle_id | Limita a uno dei tuoi veicoli (opzionale; gli id provengono da fleet/vehicles). Ometti per l'intera flotta. |
from | Inizio finestra — timestamp unix o data-ora ISO-8601 (predefinito: 24 h prima di `to`). Una data-ora senza scostamento esplicito viene letta come UTC. |
to | Fine finestra — timestamp unix o data-ora ISO-8601 (predefinito: adesso). La finestra non può superare i 31 giorni. |
limit | Numero massimo di punti restituiti, 1-5000 (predefinito 1000, i valori superiori a 5000 vengono limitati). `truncated: true` significa che nella finestra esistono altri punti. |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
data.points[].vehicle_id | Vehicle the fix belongs to, with plate. |
data.points[].lat | Position, with lon, ts, datetime (UTC) and accuracy_m. |
data.points[].speed_ms | Speed in m/s at the fix, with bearing_deg. |
data.from | Window actually queried, with to and limit. |
data.count | Points returned; truncated is true when count reached limit — continue from the last ts rather than widening the window. |
data.vehicle_id | The vehicle filtered to, null when the window covers the whole fleet. |
curl "https://nakordoni.eu/api/v2/data/fleet/history?vehicle_id=1&from=2026-08-01T00:00:00Z&to=2026-08-02T00:00:00Z&limit=1000" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Accedi come sviluppatore per provare questo endpoint dal vivo nella sandbox — 50 chiamate di prova gratuite al giorno. Accedi