API referencaWidgeti

Objava više widgeta

Do 500 procjena odjednom (cijeli lager); svaka se objavljuje zasebno.

POSThttps://api.cifra.ba/v1/widgets/batch

Pristup: widgets
Obračun: Besplatno

POST/v1/widgets/batch

curl -X POST "https://api.cifra.ba/v1/widgets/batch" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "valuation_id": "val_8fK2mQ9xLp4TvB7nR1sW",
        "asking_price": 23900,
        "external_ref": "LAG-0412"
      },
      {
        "valuation_id": "val_Q1wE2rT3yU4iO5pA6sD7",
        "asking_price": 31500,
        "external_ref": "LAG-0413"
      }
    ]
  }'

Odgovor

{
  "object": "list",
  "created": 1,
  "data": [
    {
      "index": 0,
      "widget": {
        "id": "wgt_7Hq2Lm9PzX4cV1bN8sKd",
        "object": "widget",
        "public_id": "k3M9xQ2vTa",
        "status": "active",
        "source": "valuation",
        "report_id": null,
        "valuation_id": "val_8fK2mQ9xLp4TvB7nR1sW",
        "external_ref": "LAG-0412",
        "title": null,
        "vehicle": {
          "vehicle_type": "car",
          "make": "volkswagen",
          "model": "golf_7",
          "make_name": "Volkswagen",
          "model_name": "Golf 7",
          "year": 2017,
          "mileage_km": 148000,
          "fuel": "diesel",
          "transmission": "manual",
          "power_kw": 85
        },
        "asking_price": 23900,
        "value": {
          "currency": "BAM",
          "point": 25750,
          "low": 22600,
          "high": 28900,
          "confidence_grade": "B",
          "as_of": "2026-10-21"
        },
        "rating": {
          "level": "good",
          "pct": -7.18,
          "diff_bam": -1850
        },
        "embed": {
          "page_url": "https://www.cifra.ba/w/k3M9xQ2vTa",
          "script": "<div data-cifra-widget=\"price\" data-id=\"k3M9xQ2vTa\"></div>\n<script async src=\"https://www.cifra.ba/widget.js\"></script>",
          "iframe": "<iframe src=\"https://www.cifra.ba/embed/k3M9xQ2vTa/price\" title=\"Cifra — Cijena i tržišna vrijednost\" width=\"100%\" height=\"236\" style=\"border:0;max-width:100%\" loading=\"lazy\"></iframe>"
        },
        "sold_at": null,
        "created_at": "2026-10-21T09:14:02.511Z",
        "updated_at": "2026-10-21T09:14:02.640Z"
      }
    },
    {
      "index": 1,
      "error": {
        "code": "valuation_not_found",
        "message": "No such valuation made with this company's keys."
      }
    }
  ]
}

Tijelo zahtjeva

application/json

itemsany[]obavezno1–500 stavki
Do 500 vozila, svako kao tijelo POST /v1/widgets.

Odgovor

200

objectstringobavezno
list.
createdintegerobavezno
Koliko je objavljeno.
dataobject[]obavezno
Rezultat za svako vozilo.
Prikaži 3 poljaSakrij polja
- indexintegerobavezno
  Redni broj u items.
- widgetobjectopcionalno
  Objavljeni widget.
  Prikaži 17 poljaSakrij polja
  idstringobavezno
  Oznaka (wgt_…).
  objectstringobavezno
  widget.
  public_idstringobavezno
  Javni kod u adresi widgeta (cifra.ba/embed/<public_id>/…, cifra.ba/w/<public_id>); ide u vašu stranicu.
  statusenumobavezno
  active, paused ili sold (oglas s Cifrine platforme je skinut: widgeti kažu „Prodano”).
  activepausedsold
  sourceenumobavezno
  Iz API procjene ili izvještaja s platforme.
  valuationreport
  report_idstringobavezno
  Izvještaj s platforme, kad je odatle objavljen.
  valuation_idstringobavezno
  API procjena iz koje je objavljen.
  external_refstringobavezno
  Vaša oznaka.
  titlestringobavezno
  Naziv na widgetu (null: marka, model i godište).
  vehicleobjectobavezno
  Vozilo.
  Prikaži 10 poljaSakrij polja
  vehicle_typeenumobavezno
  Vrsta vozila.
  carmotorcycletruck
  makestringobavezno
  Šifra marke.
  modelstringobavezno
  Šifra modela.
  make_namestringobavezno
  Marka.
  model_namestringobavezno
  Model.
  yearintegerobavezno
  Godište.
  mileage_kmintegerobavezno
  Kilometraža.
  fuelstringobavezno
  Gorivo.
  transmissionstringobavezno
  Mjenjač.
  power_kwnumberobavezno
  Snaga u kW.
  asking_priceinteger | nullobavezno
  Tražena cijena u KM.
  valueobject | nullobavezno
  Zadnja jutarnja procjena.
  Prikaži 6 poljaSakrij polja
  currencystringobavezno
  BAM.
  pointintegerobavezno
  Tržišna vrijednost (standardni model, nezavisan od modela vaše kompanije).
  lowinteger | nullobavezno
  Donja granica raspona.
  highinteger | nullobavezno
  Gornja granica raspona.
  confidence_gradeenum | nullobavezno
  Ocjena pouzdanosti: A najuži rasponi za takva vozila, C najširi (rijetki modeli, malo podataka, nepotpun unos).
  ABC
  as_ofstring | nullobavezno
  Dan, YYYY-MM-DD.
  ratingobject | nullobavezno
  Ocjena kakvu widget prikazuje; null bez cijene, za prodano vozilo ili cijenu daleko van tržišta.
  Prikaži 3 poljaSakrij polja
  levelenumobavezno
  Ocjena cijene: great odlična, good dobra, fair fer, high povišena, over visoka.
  greatgoodfairhighover
  pctnumberobavezno
  Tražena cijena naspram vrijednosti, u %.
  diff_bamintegerobavezno
  Razlika u KM (negativna: ispod vrijednosti).
  embedobjectobavezno
  Gotov kod; druge vrste: data-cifra-widget="badge|market|comparables|forecast|factors|mileage|report".
  Prikaži 3 poljaSakrij polja
  page_urlstringobavezno
  Stranica vozila za kupce, s cijelim izvještajem.
  scriptstringobavezno
  Kod widgeta „Cijena” sa skriptom (preporučeno).
  iframestringobavezno
  Isti widget kao iframe.
  sold_atstring | nullobavezno
  Trenutak u ISO 8601 (UTC).
  created_atstringobavezno
  Trenutak u ISO 8601 (UTC).
  updated_atstringobavezno
  Trenutak u ISO 8601 (UTC).
- errorobjectopcionalno
  Zašto nije objavljen.
  Prikaži 3 poljaSakrij polja
  codestringobavezno
  Šifra greške.
  messagestringobavezno
  Objašnjenje.
  pathstringopcionalno
  Polje s greškom.

Greške

400
invalid_request
Tijelo ili parametri ne odgovaraju šemi; errors navodi svako polje.
403
organization_required
Ključ pripada klijentu koji nije vezan za kompaniju; widgeti su kompanijini.
403
live_key_required
Testni ključ: widgeti su javni i objavljuju se samo iz stvarnih procjena.
409
widget_limit_reached
Objavljeno je onoliko vozila koliko plan dozvoljava (pauzirana se broje, prodana ne).

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

POST/v1/widgets/batch

curl -X POST "https://api.cifra.ba/v1/widgets/batch" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "valuation_id": "val_8fK2mQ9xLp4TvB7nR1sW",
        "asking_price": 23900,
        "external_ref": "LAG-0412"
      },
      {
        "valuation_id": "val_Q1wE2rT3yU4iO5pA6sD7",
        "asking_price": 31500,
        "external_ref": "LAG-0413"
      }
    ]
  }'

Odgovor

{
  "object": "list",
  "created": 1,
  "data": [
    {
      "index": 0,
      "widget": {
        "id": "wgt_7Hq2Lm9PzX4cV1bN8sKd",
        "object": "widget",
        "public_id": "k3M9xQ2vTa",
        "status": "active",
        "source": "valuation",
        "report_id": null,
        "valuation_id": "val_8fK2mQ9xLp4TvB7nR1sW",
        "external_ref": "LAG-0412",
        "title": null,
        "vehicle": {
          "vehicle_type": "car",
          "make": "volkswagen",
          "model": "golf_7",
          "make_name": "Volkswagen",
          "model_name": "Golf 7",
          "year": 2017,
          "mileage_km": 148000,
          "fuel": "diesel",
          "transmission": "manual",
          "power_kw": 85
        },
        "asking_price": 23900,
        "value": {
          "currency": "BAM",
          "point": 25750,
          "low": 22600,
          "high": 28900,
          "confidence_grade": "B",
          "as_of": "2026-10-21"
        },
        "rating": {
          "level": "good",
          "pct": -7.18,
          "diff_bam": -1850
        },
        "embed": {
          "page_url": "https://www.cifra.ba/w/k3M9xQ2vTa",
          "script": "<div data-cifra-widget=\"price\" data-id=\"k3M9xQ2vTa\"></div>\n<script async src=\"https://www.cifra.ba/widget.js\"></script>",
          "iframe": "<iframe src=\"https://www.cifra.ba/embed/k3M9xQ2vTa/price\" title=\"Cifra — Cijena i tržišna vrijednost\" width=\"100%\" height=\"236\" style=\"border:0;max-width:100%\" loading=\"lazy\"></iframe>"
        },
        "sold_at": null,
        "created_at": "2026-10-21T09:14:02.511Z",
        "updated_at": "2026-10-21T09:14:02.640Z"
      }
    },
    {
      "index": 1,
      "error": {
        "code": "valuation_not_found",
        "message": "No such valuation made with this company's keys."
      }
    }
  ]
}