API dokumentacija

Dostop

Ključ pošlješ v glavi X-Sledio-Key ali kot parameter ?key=. Ključ dobiš v svojem računu; velja samo za tvoja vozila.

curl -H "X-Sledio-Key: TVOJ_KLJUC" \
  https://sledio.si/api/v1/vozila

Stanje celotne flote — zadnji znani položaj vsakega vozila s podatki o kakovosti meritve.

{
  "vozila": [
    {
      "imei": "862272089621538",
      "ime": "MULTIVAN Hybrid",
      "registrska": "MB89MMC",
      "znamka": "Volkswagen",
      "model": "Multivan",
      "voznik": "Janez Novak",
      "polozaj": { "lat": 46.630055, "lon": 15.626603, "smer": 184 },
      "hitrost_kmh": 0,
      "kontakt": false,
      "napetost_v": 12.8,
      "natancnost_m": 2.4,
      "sateliti": 11,
      "izmerjeno": "2026-08-08T18:51:03.000Z",
      "parkiran_od": "2026-08-08T10:09:44.000Z"
    }
  ],
  "cas": "2026-08-08T18:51:20.412Z"
}

Surovi zapisi naprave za obdobje. Vsak zapis vsebuje izmerjen položaj, hitrost, število satelitov in oceno natančnosti.

{
  "imei": "862272089621538",
  "od": "2026-08-01",
  "do": "2026-08-08",
  "zapisov": 1482,
  "zapisi": [
    {
      "recorded_at": 1786161063000,
      "lat": 46.630055, "lon": 15.626603,
      "speed": 0, "angle": 184, "sats": 11,
      "accuracy_m": 2.4,
      "gps_lat": 46.6300549, "gps_lon": 15.6266033,
      "ignition": 0, "ext_voltage_mv": 12826,
      "odometer_total_m": 28412
    }
  ]
}

Kaj pomeni natančnost

Polje natancnost_m ni ocena proizvajalca, ampak izmerjen raztros zaporednih meritev na istem mestu. Poleg obdelanega položaja hranimo tudi surovo meritev naprave (gps_lat, gps_lon), da je vedno preverljivo, kaj je izmerila naprava in kaj je izračunal Sledio.

Omejitve in pravila

• • Odgovori niso predpomnjeni — vedno vrnejo trenutno stanje.
• • Priporočena pogostost: enkrat na 5 sekund za živo stanje, zgodovina po potrebi.
• • Vsi časi so v UTC po standardu ISO 8601.
• • Če meritve ni, je polje null — nikoli ne vrnemo ocenjene vrednosti.