Docs

API referencaPraćenje vozila

Historija vrijednosti

Vrijednost vozila za svaki dan praćenja, s rasponom, kilometražom i verzijom modela. Podrazumijevano zadnjih 90 dana.

GEThttps://api.cifra.ba/v1/watchlist/{id}/history
Pristup
watchlist
Obračun
Besplatno
GET/v1/watchlist/{id}/history
curl "https://api.cifra.ba/v1/watchlist/wv_3JdP0aZr6YcN2uE5kHq8/history?from=2026-10-18&to=2026-10-21" \
  -H "Authorization: Bearer $CIFRA_API_KEY"
Odgovor
{
  "object": "list",
  "watched_vehicle_id": "wv_3JdP0aZr6YcN2uE5kHq8",
  "from": "2026-10-18",
  "to": "2026-10-21",
  "data": [
    {
      "day": "2026-10-18",
      "point": 22350,
      "low": 18610,
      "high": 26790,
      "confidence_grade": "A",
      "change_pct": null,
      "mileage_km": 148000,
      "model_version": "car-20261017-1"
    },
    {
      "day": "2026-10-19",
      "point": 22330,
      "low": 18590,
      "high": 26770,
      "confidence_grade": "A",
      "change_pct": -0.09,
      "mileage_km": 148049,
      "model_version": "car-20261017-1"
    },
    {
      "day": "2026-10-20",
      "point": 22310,
      "low": 18580,
      "high": 26740,
      "confidence_grade": "A",
      "change_pct": -0.09,
      "mileage_km": 148099,
      "model_version": "car-20261017-1"
    },
    {
      "day": "2026-10-21",
      "point": 22300,
      "low": 18570,
      "high": 26730,
      "confidence_grade": "A",
      "change_pct": -0.04,
      "mileage_km": 148148,
      "model_version": "car-20261017-1"
    }
  ]
}

Parametri putanje

  • idstringobavezno

    Oznaka vozila (wv_…).

Parametri upita

  • fromdateopcionalno

    Od dana (YYYY-MM-DD); podrazumijevano 90 dana prije to.

  • todateopcionalno

    Do dana (YYYY-MM-DD); podrazumijevano danas.

Odgovor

200
  • objectstringobavezno

    list.

  • watched_vehicle_idstringobavezno

    Vozilo.

  • fromstringobavezno

    Od dana.

  • tostringobavezno

    Do dana.

  • dataobject[]obavezno

    Vrijednost za svaki dan, od najstarijeg.

    Prikaži 8 polja
    • daystringobavezno

      Dan, YYYY-MM-DD.

    • pointintegerobavezno

      Vrijednost.

    • lowintegerobavezno

      Donja granica.

    • highintegerobavezno

      Gornja granica.

    • confidence_gradestringobavezno

      Ocjena.

    • change_pctnumberobavezno

      Promjena od prethodne procjene, %.

    • mileage_kmintegerobavezno

      Kilometraža tog dana.

    • model_versionstringobavezno

      Verzija modela.

Greške

  • 400
    invalid_request

    Tijelo ili parametri ne odgovaraju šemi; errors navodi svako polje.

  • 404
    not_found

    Ne postoji, ili pripada drugoj kompaniji ili drugom okruženju.

Uz ove, svaki poziv s ključem može vratiti opšte greške (ključ, pristup, limiti).