Docs

APIProcjene

Masovna procjena

Stotine vozila u jednom pozivu: portfelji, lageri, cjenovnici.

POST /v1/valuations/batch prima listu vozila, svako kao tijelo pojedinačne procjene. Svako se provjerava i procjenjuje zasebno: neispravno vraća error na svom mjestu, ostala se procijene. Odgovor je istim redom; index je mjesto u listi.

POST/v1/valuations/batch
curl -X POST "https://api.cifra.ba/v1/valuations/batch" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": [
      "explanation"
    ],
    "items": [
      {
        "make": "audi",
        "model": "a4",
        "year": 2016,
        "mileage_km": 190000,
        "fuel": "diesel",
        "transmission": "automatic"
      },
      {
        "make": "škoda",
        "model": "octavia",
        "year": 2015,
        "mileage_km": 210000
      },
      {
        "make": "volkswagen",
        "model": "pasat",
        "year": 2015,
        "mileage_km": 200000
      }
    ]
  }'

Veličina i brzina

BusinessEnterpriseSandbox
Vozila u pozivu100do 1.000 (ugovor)10
Tijelo zahtjevado 2 MBdo 2 MBdo 2 MB
  • Bez include lista vraća samo vrijednosti — najbrže. Obračun traži samo kad ga prikazujete (oko 50 ms po vozilu).
  • Veće liste podijelite na dijelove i šaljite ih jedan za drugim ili s malo paralelnih zahtjeva, u okviru limita u minuti.
  • Ponovite samo vozila s greškom 5xx/429, ne cijelu listu: uspjela su već naplaćena.
const CHUNK = 100;
const results = [];
for (let i = 0; i < vehicles.length; i += CHUNK) {
  const items = vehicles.slice(i, i + CHUNK);
  const res = await cifra("/v1/valuations/batch", {
    method: "POST",
    body: JSON.stringify({ items }),
  });
  for (const r of res.data) results[i + r.index] = r;
}
const failed = results.filter((r) => r.error);
Na platformi isto radi Masovna procjena: učitate Excel, mapirate kolone i preuzmete rezultat, bez koda. Webhook bulk.completed javi kad je lista gotova.