API referencaPraćenje vozila

Izmjena praćenog vozila

Mijenja samo poslana polja: novo očitanje kilometraže, pravila alarma, izloženost (npr. nakon rate kredita), pauza.

PATCHhttps://api.cifra.ba/v1/watchlist/{id}

Pristup: watchlist
Obračun: Besplatno

PATCH/v1/watchlist/{id}

curl -X PATCH "https://api.cifra.ba/v1/watchlist/wv_3JdP0aZr6YcN2uE5kHq8" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mileage_km": 151200,
    "alerts": {
      "change_pct": 4
    },
    "exposure": {
      "kind": "financing",
      "amount_bam": 18425,
      "as_of": "2026-11-01",
      "term_months": 35,
      "annual_rate_pct": 6.9,
      "balloon_bam": 12000
    }
  }'

Odgovor

{
  "object": "watched_vehicle",
  "id": "wv_3JdP0aZr6YcN2uE5kHq8",
  "kind": "owned",
  "status": "active",
  "label": "VW Golf 7 — ugovor 2024/118",
  "external_ref": "2024/118",
  "tags": [
    "lizing",
    "sarajevo"
  ],
  "note": null,
  "vehicle": {
    "vehicle_type": "car",
    "make": "volkswagen",
    "model": "golf_7",
    "year": 2017,
    "mileage_km": 148000,
    "power_kw": 85,
    "fuel": "diesel",
    "transmission": "manual",
    "make_name": "Volkswagen",
    "model_name": "Golf 7"
  },
  "mileage": {
    "today_km": 151200,
    "given_km": 151200,
    "given_on": "2026-11-01",
    "km_per_year": 18000
  },
  "alerts": {
    "change_pct": 4,
    "direction": "down",
    "below_bam": null,
    "above_bam": null,
    "exposure_pct": 85,
    "deal_pct": null
  },
  "exposure": {
    "kind": "financing",
    "amount_bam": 18425,
    "as_of": "2026-11-01",
    "term_months": 35,
    "annual_rate_pct": 6.9,
    "balloon_bam": 12000,
    "today_bam": 18425,
    "ratio": 0.8244
  },
  "baseline": {
    "value": 22350,
    "on": "2026-10-18"
  },
  "latest": {
    "on": "2026-10-18",
    "point": 22350,
    "low": 18610,
    "high": 26790,
    "confidence_grade": "A",
    "model_version": "car-20261017-1"
  },
  "forecast": {
    "km_per_year": 18000,
    "points": [
      {
        "months": 6,
        "point": 21280,
        "low": 16270,
        "high": 26330
      },
      {
        "months": 12,
        "point": 20270,
        "low": 14540,
        "high": 25760
      },
      {
        "months": 24,
        "point": 18420,
        "low": 13670,
        "high": 23160
      },
      {
        "months": 36,
        "point": 16760,
        "low": 11910,
        "high": 21520
      }
    ]
  },
  "change_since_baseline_pct": 0,
  "created_at": "2026-10-18T22:04:11.532Z",
  "updated_at": "2026-11-01T10:02:37.118Z"
}

Parametri putanje

idstringobavezno
Oznaka vozila (wv_…).

Tijelo zahtjeva

application/json

labelstring | nullopcionalnodo 120 znakova
Novi naziv; null briše.
external_refstring | nullopcionalnodo 120 znakova
Nova vaša oznaka; null briše.
statusenumopcionalno
paused zaustavlja dnevnu procjenu i alarme; active ih vraća.
activepaused
km_per_yearinteger | nullopcionalno0 – 150.000
Vlastita vozila: novi godišnji prosjek kilometara.
mileage_kmintegeropcionalno0 – 2.000.000
Vlastita vozila: novo očitanje brojila; kilometraža dalje raste od njega, od danas.
alertsobjectopcionalno
Pravila koja mijenjate; ostala ostaju kakva jesu.
Prikaži 6 poljaSakrij polja
- change_pctnumber | nullopcionalno3 – 90
  Alarm kad se vrijednost pomjeri za ovoliko posto: od početne vrijednosti, zatim od vrijednosti pri zadnjem alarmu. Najmanje 3, jer samo ponovno treniranje modela pomjeri vrijednosti ~2%. null isključuje.
- directionenumopcionalno
  Koji pomak broji za change_pct: any (podrazumijevano), up ili down.
  anyupdown
- below_baminteger | nullopcionalno100 – 5.000.000
  Alarm kad vrijednost padne ispod ove cijene (KM).
- above_baminteger | nullopcionalno100 – 5.000.000
  Alarm kad vrijednost poraste iznad ove cijene (KM).
- exposure_pctnumber | nullopcionalno10 – 300
  Vlastita vozila: alarm na dan kad izloženost (dug, osigurana suma, trošak) dostigne ovaj postotak vrijednosti (LTV), samo pri rastu.
- deal_pctnumber | nullopcionalno5 – 50
  Tražena vozila: alarm za svaki novi oglas iste specifikacije koji traži ovoliko posto manje od Cifrine cijene (najviše 5 dnevno).
exposureobject | nullopcionalno
Nova izloženost; null je uklanja.
Prikaži 6 poljaSakrij polja
- kindenumobavezno
  financing: stanje kredita ili lizinga (otplaćuje se); insured: osigurana suma; cost: nabavna cijena.
  financinginsuredcost
- amount_bamintegerobavezno100 – 20.000.000
  Iznos u KM na dan as_of.
- as_ofdateopcionalno
  Dan na koji važi amount_bam (podrazumijevano danas).
- term_monthsinteger | nullopcionalno1 – 240
  financing: preostali broj mjeseci; stanje se otplaćuje do balloon_bam, a nakon roka je nula.
- annual_rate_pctnumber | nullopcionalno0 – 40
  financing: nominalna godišnja kamata za anuitetnu otplatu; 0 znači linearnu.
- balloon_baminteger | nullopcionalno0 – 20.000.000
  financing: ostatak na kraju roka (balon rata, otkupna vrijednost).
tagsstring[]opcionalnodo 10 stavki
Zamjenjuje sve oznake.
notestring | nullopcionalnodo 2000 znakova
Nova napomena; null briše.

Odgovor

200

objectstringobavezno
watched_vehicle.
idstringobavezno
Oznaka (wv_…).
kindenumobavezno
owned ili wanted.
ownedwanted
statusenumobavezno
active ili paused.
activepaused
labelstringobavezno
Naziv.
external_refstringobavezno
Vaša oznaka.
tagsstring[]obavezno
Vaše grupe.
notestringobavezno
Napomena.
vehicleobjectobavezno
Vozilo kako ste ga poslali, s nazivima iz šifarnika.
Prikaži 5 poljaSakrij polja
- vehicle_typeenumobavezno
  Vrsta vozila.
  carmotorcycletruck
- makestringobavezno
  Šifra marke.
- modelstringobavezno
  Šifra modela.
- make_namestringobavezno
  Naziv marke.
- model_namestringobavezno
  Naziv modela.
mileageobjectobavezno
Kilometraža: vlastitim vozilima raste svaki dan.
Prikaži 4 poljaSakrij polja
- today_kmintegerobavezno
  Procijenjena kilometraža danas.
- given_kmintegerobavezno
  Zadnja kilometraža koju ste poslali.
- given_onstringobavezno
  Kad ste je poslali.
- km_per_yearinteger | nullobavezno
  Godišnji prosjek.
alertsobjectobavezno
Pravila alarma.
Prikaži 6 poljaSakrij polja
- change_pctnumberobavezno
  Prag promjene, %.
- directionenumobavezno
  Smjer.
  anyupdown
- below_baminteger | nullobavezno
  Donja ciljna cijena.
- above_baminteger | nullobavezno
  Gornja ciljna cijena.
- exposure_pctnumberobavezno
  LTV prag, %.
- deal_pctnumberobavezno
  Prag povoljnog oglasa, %.
exposureobject | nullobavezno
Izloženost (samo vlastita vozila).
Prikaži 8 poljaSakrij polja
- kindenumobavezno
  Vrsta izloženosti.
  financinginsuredcost
- amount_bamintegerobavezno
  Iznos na dan as_of.
- as_ofstringobavezno
  Dan na koji važi iznos.
- term_monthsinteger | nullobavezno
  Preostali mjeseci.
- annual_rate_pctnumberobavezno
  Godišnja kamata.
- balloon_baminteger | nullobavezno
  Ostatak na kraju.
- today_bamintegerobavezno
  Iznos danas, nakon otplate.
- rationumberobavezno
  Iznos danas ÷ zadnja vrijednost (LTV), npr. 0.84.
baselineobjectobavezno
Polazna vrijednost.
Prikaži 2 poljaSakrij polja
- valueintegerobavezno
  Vrijednost kad je praćenje počelo.
- onstringobavezno
  Dan.
latestobject | nullobavezno
Zadnja dnevna procjena.
Prikaži 6 poljaSakrij polja
- onstringobavezno
  Dan zadnje procjene.
- pointinteger | nullobavezno
  Vrijednost.
- lowinteger | nullobavezno
  Donja granica.
- highinteger | nullobavezno
  Gornja granica.
- confidence_gradestringobavezno
  Ocjena.
- model_versionstringobavezno
  Verzija modela.
forecastobject | nullobavezno
Prognoza iz zadnje dnevne procjene.
Prikaži 2 poljaSakrij polja
- km_per_yearintegerobavezno
  Pretpostavljena godišnja kilometraža.
- pointsobject[]obavezno
  Vrijednost kroz 6–36 mjeseci.
  Prikaži 4 poljaSakrij polja
  monthsintegerobavezno
  Mjeseci od zadnje procjene.
  pointintegerobavezno
  Vrijednost.
  lowintegerobavezno
  Donja granica.
  highintegerobavezno
  Gornja granica.
change_since_baseline_pctnumberobavezno
Promjena od polazne vrijednosti, %.
created_atstringobavezno
Trenutak u ISO 8601 (UTC).
updated_atstringobavezno
Trenutak u ISO 8601 (UTC).

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.
422
not_owned
km_per_year, mileage_km ili exposure za traženo (wanted) vozilo.
422
not_wanted
deal_pct za vlastito (owned) vozilo.

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

PATCH/v1/watchlist/{id}

curl -X PATCH "https://api.cifra.ba/v1/watchlist/wv_3JdP0aZr6YcN2uE5kHq8" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mileage_km": 151200,
    "alerts": {
      "change_pct": 4
    },
    "exposure": {
      "kind": "financing",
      "amount_bam": 18425,
      "as_of": "2026-11-01",
      "term_months": 35,
      "annual_rate_pct": 6.9,
      "balloon_bam": 12000
    }
  }'

Odgovor

{
  "object": "watched_vehicle",
  "id": "wv_3JdP0aZr6YcN2uE5kHq8",
  "kind": "owned",
  "status": "active",
  "label": "VW Golf 7 — ugovor 2024/118",
  "external_ref": "2024/118",
  "tags": [
    "lizing",
    "sarajevo"
  ],
  "note": null,
  "vehicle": {
    "vehicle_type": "car",
    "make": "volkswagen",
    "model": "golf_7",
    "year": 2017,
    "mileage_km": 148000,
    "power_kw": 85,
    "fuel": "diesel",
    "transmission": "manual",
    "make_name": "Volkswagen",
    "model_name": "Golf 7"
  },
  "mileage": {
    "today_km": 151200,
    "given_km": 151200,
    "given_on": "2026-11-01",
    "km_per_year": 18000
  },
  "alerts": {
    "change_pct": 4,
    "direction": "down",
    "below_bam": null,
    "above_bam": null,
    "exposure_pct": 85,
    "deal_pct": null
  },
  "exposure": {
    "kind": "financing",
    "amount_bam": 18425,
    "as_of": "2026-11-01",
    "term_months": 35,
    "annual_rate_pct": 6.9,
    "balloon_bam": 12000,
    "today_bam": 18425,
    "ratio": 0.8244
  },
  "baseline": {
    "value": 22350,
    "on": "2026-10-18"
  },
  "latest": {
    "on": "2026-10-18",
    "point": 22350,
    "low": 18610,
    "high": 26790,
    "confidence_grade": "A",
    "model_version": "car-20261017-1"
  },
  "forecast": {
    "km_per_year": 18000,
    "points": [
      {
        "months": 6,
        "point": 21280,
        "low": 16270,
        "high": 26330
      },
      {
        "months": 12,
        "point": 20270,
        "low": 14540,
        "high": 25760
      },
      {
        "months": 24,
        "point": 18420,
        "low": 13670,
        "high": 23160
      },
      {
        "months": 36,
        "point": 16760,
        "low": 11910,
        "high": 21520
      }
    ]
  },
  "change_since_baseline_pct": 0,
  "created_at": "2026-10-18T22:04:11.532Z",
  "updated_at": "2026-11-01T10:02:37.118Z"
}