Váš API kľúč
Použite ho v Authorization hlavičke každej požiadavky.
demo_tk_live_4fJd7sKx9NpQ2vWaV demo režime je kľúč zdieľaný. V produkcii vygenerujeme jedinečný kľúč na firmu a môžete vytvárať aj read-only kľúče pre účtovnícky softvér.
Endpointy
v1 · REST · JSON| Metóda | Cesta | Popis |
|---|---|---|
| GET | /api/v1/vehicles | Zoznam vozidiel (pridať ?live=true pre aktuálnu pozíciu) |
| GET | /api/v1/vehicles/{id} | Detail vozidla + telemetria |
| GET | /api/v1/trips | Kniha jázd. Filtre: ?vehicle_id, ?purpose=BUSINESS|PRIVATE, ?from, ?to, ?limit |
| GET | /api/v1/drivers | Zoznam vodičov |
| GET | /api/v1/fuel | Tankovania (?vehicle_id na filter) |
| GET | /api/v1/summary | Mesačné súčty (?days=30) |
Príklad — curl
curl -H "Authorization: Bearer demo_tk_live_4fJd7sKx9NpQ2vWa" \ https://gps.it-dk.sk/api/v1/vehicles?live=true
Príklad — JavaScript
const res = await fetch("https://gps.it-dk.sk/api/v1/trips?purpose=BUSINESS&limit=50", {
headers: { Authorization: "Bearer demo_tk_live_4fJd7sKx9NpQ2vWa" }
});
const { data, meta } = await res.json();
console.log(`Pracovných jázd: ${data.length}`);Rate limiting & best practices
Limit pre demo kľúč: 60 požiadaviek za minútu. Pri prekročení dostanete HTTP 429 s hlavičkou Retry-After.
Pre webhook integrácie (push notifikácie pri novej jazde, vstup do geo-zóny, alarm) napíšte na info@it-dk.sk.
Stream telemetrie cez SSE: https://gps.it-dk.sk/api/live/stream (interný, prehliadač iba — pre server-side push použite webhooky).