Cifra API za developere

Procjene vozila u vašem sistemu, za par minuta

Tržišna vrijednost s rasponom i obračunom, provjera oglasa, praćenje portfelja s LTV alarmima i webhookovi — iz istih modela koje koristi Cifra. Za lizing, banke, osiguranja, salone i oglasnike.

Procjena vozila

Vrijednost, raspon od 80% i obračun po faktorima.

Dokumentacija

Volkswagen Golf 7 · 2017 · 148.000 km · 85 kW dizel

22.350KM

Ocjena A

Tržišna vrijednost danas

18.610raspon 80%26.790

Prognoza (36 mj.)17.150 KM za 3 godine

model car-20261017-1

Obračun cijene

Bazna vrijednost modela22.950 KM
Kilometraža+3.270 KM
Oprema i motorizacija−3.090 KM
Stanje i historija vozila−20 KM
Regionalna potražnja−230 KM
Stanje tržišta−530 KM

Tržišna vrijednost22.350 KM

Linije se tačno sabiraju u vrijednost; nazivi su spremni za prikaz kupcu.

oglasa iz kojih uči model za automobile: 190.000; oglasa iz kojih uči model za automobile
medijan greške na novim oglasima: 12,6%; medijan greške na novim oglasima
cijena padne u raspon koji vratimo: 8 od 10; cijena padne u raspon koji vratimo
za procjenu, bez čekanja na red: 0,2 ms; za procjenu, bez čekanja na red
vrste vozila: auto, motocikl, kamion: 3; vrste vozila: auto, motocikl, kamion

Cijela Cifra, kroz jedan API

Nabavi API ključ Dokumentacija

Isti modeli i podaci kao u Cifri i na platformi za kompanije: 250.000+ oglasa iz cijele BiH, čišćenih i povezanih po vozilu. REST i JSON, primjeri u sedam jezika i OpenAPI za vaš generator klijenta.

Procjena vozila

Vrijednost, raspon od 80% i ocjena; obračun po faktorima, prognoza i slična vozila.

POST /v1/valuations
{
  "make": "volkswagen",
  "model": "golf_7",
  "year": 2017,
  "mileage_km": 148000
}

Golf 7 · 2017 · 148.000 km

22.350 KM

18.610Ocjena A26.790

Masovna procjena

Stotine vozila u pozivu; svako uspije ili padne samo za sebe, naplata po uspjelom.

POST /v1/valuations/batch
{ "items": [
  { ... }, { ... },
  { ... }
] }
"valued": 97,
"failed": 3

Audi A4 · 201629.450

Octavia · 201515.600

Passat · 201828.900

Provjera vozila

Za link oglasa: svi oglasi istog vozila, vraćena kilometraža, tuđe fotografije, lizing.

GET /v1/vehicle-history
  ?listing_url=olx.ba/...
"level": "elevated",
"signals": [
  "mileage_rollback",
  "relisted_often"
]

Povećan oprez

Kilometraža pala za 38.000 km

Oglašeno 4 puta za 9 mj.

Iste fotografije u drugom oglasu

Webhookovi

Alarmi, izvještaj i rad tima na platformi, potpisani i s ponovnim pokušajima.

Cifra-Signature: t=1760772764,
  v1=5f2b0c9e8a...
{ "type": "watchlist.alert",
  "data": { ... } }

watchlist.alert200

check.completed200

bulk.completed200

Napravljeno za produkciju

Ono što integracijski tim banke provjerava prije potpisa: test bez rizika, jasni limiti, greške po kojima se može granati, kontrola ključeva i trag svakog zahtjeva.

Testni ključ prolazi istu provjeru zahtjeva i vraća iste greške, a odgovara fiksnim vrijednostima i ništa ne naplaćuje. Podaci testa i produkcije su potpuno odvojeni.
```
{
  "id": "val_Hc2WqLx9TzE4nVb7RkPa",
  "sandbox": true,
  "market_value": {
    "point": 24350,
    "low": 22650,
    "high": 26050,
    "confidence_grade": "B"
  }
}
```
Svaki odgovor kaže koliko zahtjeva i jedinica ostaje. Preko limita dobijate 429 s tačnim vremenom čekanja, a kvota je zajednička za sve ključeve kompanije.
```
HTTP/2 201
x-request-id: d930cbb0-d0e5-48c8-8ec2-4647ad48a98b
x-ratelimit-limit: 120
x-ratelimit-remaining: 117
x-ratelimit-reset: 42
x-quota-remaining: 8214
```
Svaka greška je application/problem+json sa stabilnom šifrom, oznakom zahtjeva i, kad je ulaz neispravan, listom polja. Lista od 100 vozila ne pada zbog jednog.
```
{
  "status": 422,
  "code": "unknown_model",
  "detail": "Unknown model \"golf_99\" for Volkswagen…",
  "field": "model",
  "request_id": "db158528-2355-456f…"
}
```
Pristup po usluzi, dozvoljene IP adrese, mjesečni limit po ključu, pauza jednim klikom i zamjena ključa bez prekida — stari radi dok ne pređete na novi.
Core bankingcfr_live_6fN0…pristup valuations10.2.0.0/16
CRMcfr_live_Qm4t…pristup watchlist185.12.4.20
Testovicfr_test_8fK2…pristup sve—
Alarmi, dnevni izvještaj i rad tima stižu potpisani HMAC-SHA256. Ako vaša adresa ne odgovori, Cifra pokušava ponovo do dva dana i javi vam ako adresa dugo ne radi.
1. 1. pokušaj503
2. 2. pokušaj · nakon 1 mintimeout
3. 3. pokušaj · nakon 5 mintimeout
4. 4. pokušaj · nakon 30 mintimeout
5. 5. pokušaj · nakon 2 h200
Na platformi vidite svaki zahtjev vaših ključeva: status, trajanje, jedinice i, kod greške, tijelo zahtjeva. Podrška nalazi problem po jednoj oznaci zahtjeva.
09:41:12POST/v1/valuations20138 ms
09:41:09POST/v1/valuations/batch200212 ms
09:40:57GET/v1/vehicle-history20064 ms
09:40:31POST/v1/valuations4229 ms
09:39:58GET/v1/watchlist/report20071 ms
Specifikacija iz istih šema kojima API provjerava zahtjeve: uvoz u Postman, generisanje klijenta, primjeri za cURL, JavaScript, Python, PHP, C#, Javu i Go.
cURLJavaScriptPythonPHPC#JavaGoOpenAPI 3.1llms.txt

{
  "id": "val_Hc2WqLx9TzE4nVb7RkPa",
  "sandbox": true,
  "market_value": {
    "point": 24350,
    "low": 22650,
    "high": 26050,
    "confidence_grade": "B"
  }
}

Tačnost koju možete provjeriti

Mjerimo na oglasima objavljenim nakon zadnjeg dana učenja, bez vozila koja model već zna. Svaki novi model mora biti jednako dobar ili bolji od onog koji radi, prije nego što ijedan klijent dobije njegov broj.

medijan greške, automobili: 12,6%; medijan greške, automobili; 18.984 novih oglasa koje model nije vidio
naspram stvarnih prodaja: 7,4%; naspram stvarnih prodaja; 786 prodaja auto salona
cijena u rasponu od 80%: 79%; cijena u rasponu od 80%; kalibrisano, provjereno na svakom modelu
greška prognoze: 9,2%; greška prognoze; 693 vozila ponovo oglašenih za 1–2 godine

Motocikli 15,7%, kamioni 21,9%. Stanje: oktobar 2026. Svaki odgovor imenuje model koji ga je dao.

Kako mjerimo

Za posao kojim se bavite

Isti API, drugačija pitanja. Svaka industrija ima recept u dokumentaciji, s kodom koji možete kopirati.

Kolateral koji pratite svaki dan, ne jednom godišnje

Uvezite portfelj jednom; Cifra svako jutro procijeni svako vozilo, izračuna stanje kredita i javi kad LTV pređe vaš prag.

Procjena pri odobrenju, s rasponom i obračunom za kreditni odbor
Praćenje portfelja s izloženošću i LTV alarmima
Prognoza vrijednosti na kraju ugovora za rezidual

Recept: LTV portfelj

Počnite danas, rastite s ugovorom

API je dio plana Business — 7 dana besplatno, sa sandbox ključevima od prvog dana. Za veći obim, vaš model i ugovor, tu je Enterprise.

Business

500 KM

mjesečno · 7 dana besplatno · 5000 KM godišnje

10.000 jedinica mjesečno, zajedničkih za sve ključeve
120 zahtjeva u minuti, do 100 vozila u listi
1.000 praćenih vozila, alarmi i webhookovi
Sandbox ključevi bez naplate
Log zahtjeva, potrošnja i obavještenja o kvoti
Cijela platforma: 10 članova tima, masovna procjena, Radar, Rezidual

Isprobaj 7 dana Već imate nalog? Napravite ključ

Enterprise

Po dogovoru

za banke, lizing, osiguranja, uvoznike i oglasnike

Limiti i kvota po vašem obimu, do 1.000 vozila u listi
Vaš model: procjene naučene na vašim cijenama
Ugovor, SLA i obrada podataka (DPA)
Posvećeni menadžer i pomoć pri integraciji
Plaćanje po fakturi

Razgovarajmo Kako se računaju jedinice

Šta troši jedinicu

Procjena, provjera oglasa i vozilo koje počne da se prati — 1 jedinica. U listi: po uspjelom vozilu.

Besplatno: šifarnik, čitanje, dnevne procjene praćenih vozila, alarmi, izvještaji, greške i sandbox.

Kontakt za biznis

Zakažite demo za vaš tim.

Recite nam kako danas procjenjujete vozila — pripremićemo demo na primjerima iz vaše industrije.

1
Javimo vam se
Odgovaramo s prijedlogom termina za kratak razgovor.
2
Demo za vašu industriju
Pokažemo procjene na vozilima i procesima koje vi koristite.
3
Pilot na vašim podacima
Rezultate vidite na vlastitim vozilima, prije ugovora.

Česta pitanja

Nema odgovora koji tražite? Dokumentacija ili pišite nam.

Šta je Cifra API?

REST API koji vašem sistemu daje isto što i Cifra: tržišnu vrijednost automobila, motocikla ili kamiona s rasponom i obračunom, historiju vozila kroz oglase sa signalima rizika, i praćenje portfelja s alarmima i webhookovima.

Kako dobijam pristup?

API je dio plana Business (500 KM mjesečno, 7 dana besplatno) i Enterprise ugovora. Na platformi u Razvoj → API ključevi napravite testni ključ i odmah šaljete zahtjeve; live ključ kad integracija radi.

Šta tačno znači vrijednost koju API vrati?

Tržišna vrijednost je cijena po kojoj se uporedivo vozilo oglašava kod privatnog prodavca u BiH na dan procjene. Uz nju dolazi raspon u kojem je cijena s vjerovatnoćom od 80% i ocjena pouzdanosti. Za otkup, kredit ili osiguranje na nju primjenjujete svoja pravila — ili svoj model.

Koliko su procjene tačne?

Na novim oglasima automobila koje model nikad nije vidio medijan greške je 12,6%, a naspram stvarnih prodaja auto salona 7,4%. U raspon od 80% padne 79% cijena. Detalji su u dokumentaciji, u Tačnost i modeli.

Kako se naplaćuje?

Po jedinici: procjena, provjera oglasa i novo praćeno vozilo su jedna jedinica; u masovnoj procjeni plaćate samo uspjela vozila. Čitanja, šifarnik, dnevne procjene praćenih vozila, greške i sandbox su besplatni. Kvota je zajednička za sve ključeve kompanije.

Koliki su limiti?

Business ima 120 zahtjeva u minuti i do 100 vozila u jednoj listi; Enterprise po ugovoru. Svaki odgovor nosi zaglavlja s preostalim zahtjevima i jedinicama, a preko limita dobijate 429 s vremenom čekanja.

Mogu li koristiti svoje cijene?

Da, uz Enterprise: na platformi učitate svoje prodaje, otkupe ili procjene i dobijete svoj model. API tada vraća vrijednost po vašem modelu i tržišnu vrijednost uz nju. Vaši podaci nikad ne ulaze u Cifrin model niti ih vide drugi.

Imate li SDK?

Dokumentacija ima primjere za cURL, JavaScript, Python, PHP, C#, Javu i Go uz svaki endpoint, a OpenAPI 3.1 specifikacija omogućava da generišete klijent za bilo koji jezik ili uvezete API u Postman.

Kako saznajem za promjene odmah?

Webhookovima: alarmi praćenih vozila, jutarnji izvještaj, procjene i provjere s platforme, gotove masovne liste i prag potrošnje stižu na vašu HTTPS adresu, potpisani i s ponovnim pokušajima do dva dana.

Gdje su podaci i ko ih vidi?

Vaše procjene, praćena vozila i webhookovi vidljivi su samo ključevima vaše kompanije i vašem timu na platformi, odvojeno za test i produkciju. Ključevi se čuvaju samo kao sažeci, a log zahtjeva 30 dana.

Podržavate li motocikle i kamione?

Da. Svaka vrsta vozila ima svoj model, šifarnik i polja: za motocikle tip i ABS, za kamione nadogradnju, osovine i nosivost.

Šta ako API vrati grešku?

Greška ima stabilnu šifru i oznaku zahtjeva. Ponavljajte samo 429 i 5xx, s čekanjem; ostale greške kažu tačno koje polje ispraviti. Log zahtjeva na platformi pokazuje svaki zahtjev s tijelom neuspjelog.

Novosti

Sve novosti

Cifra BlogPredstavljamo Cifru 2.0

Predstavljamo Cifru 2.0

16. okt 2026.

Tržišna vrijednost vozila u BiH, jednim pozivom.

Dokumentacija Nabavi API ključ

Procjene vozila u vašem sistemu, za par minuta

Cijela Cifra, kroz jedan API

Procjena vozila

Masovna procjena

Provjera vozila

Praćenje i LTV

Webhookovi

Vaš model

Napravljeno za produkciju

Tačnost koju možete provjeriti

Za posao kojim se bavite

Kolateral koji pratite svaki dan, ne jednom godišnje

Počnite danas, rastite s ugovorom

Zakažite demo za vaš tim.

Česta pitanja

Novosti

Predstavljamo Cifru 2.0