Docs

API referencaWidgeti

Izmjena widgeta

Nova cijena, oznaka, naziv, kilometraža (procjenjuje se odmah ponovo) ili pauza. Stranice pokazuju izmjenu za najviše 5 minuta.

PATCHhttps://api.cifra.ba/v1/widgets/{id}
Pristup
widgets
Obračun
Besplatno
PATCH/v1/widgets/{id}
curl -X PATCH "https://api.cifra.ba/v1/widgets/wgt_7Hq2Lm9PzX4cV1bN8sKd" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "asking_price": 22900
  }'
Odgovor
{
  "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": 22900,
  "value": {
    "currency": "BAM",
    "point": 25750,
    "low": 22600,
    "high": 28900,
    "confidence_grade": "B",
    "as_of": "2026-10-21"
  },
  "rating": {
    "level": "good",
    "pct": -11.07,
    "diff_bam": -2850
  },
  "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"
}

Parametri putanje

  • idstringobavezno

    Oznaka (wgt_…) ili javni kod.

Tijelo zahtjeva

application/json
  • asking_priceinteger | nullopcionalno100 – 10.000.000

    Nova tražena cijena; null prikazuje samo vrijednost. Na stranicama za najviše 5 minuta.

  • external_refstring | nullopcionalnodo 80 znakova

    Vaša oznaka; null je briše.

  • titlestring | nullopcionalnodo 120 znakova

    Naziv na widgetu; null vraća marku, model i godište.

  • statusenumopcionalno

    paused skriva widgete (stranica se zatvori), active ih vraća — i prodano vozilo koje je ponovo u prodaji.

    activepaused
  • mileage_kmintegeropcionalno0 – 3.000.000

    Novo očitanje kilometraže: vozilo se odmah procjenjuje ponovo.

  • price_from_listingbooleanopcionalno

    Samo za vozila objavljena s oglasom na Cifrinoj platformi: cijena prati oglas.

Odgovor

200
  • 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 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 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 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 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).

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.

  • 409
    duplicate_external_ref

    Vaša oznaka je već na drugom widgetu.

  • 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).