API referencaOstalo
Webhook događaji
Događaji koje Cifra šalje na vaše webhook adrese, s primjerom tijela svakog.
Svaki događaj stiže kao POST s tijelom { id, type, created_at, livemode, data }, potpisan zaglavljem Cifra-Signature. Kako primiti i provjeriti: Webhookovi.
watchlist.alertAPIAlarm za praćeno vozilo. Pravilo vozila se aktiviralo: vrijednost se promijenila, prešla ciljnu cijenu ili LTV prag, ili je stigao povoljan oglas.
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "watchlist.alert",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"alert": {
"object": "alert",
"id": "alr_8fK2mQ9xLp4TvB7nR1sW",
"type": "value_changed",
"watched_vehicle": {
"id": "wv_3JdP0aZr6YcN2uE5kHq8",
"label": "VW Golf 1.6 TDI — ugovor 2024/118",
"external_ref": "2024/118",
"kind": "owned"
},
"day": "2026-10-15",
"previous_value": 21400,
"value": 20550,
"change_pct": -3.97,
"threshold": 3,
"details": null,
"created_at": "2026-10-15T06:12:44.000Z"
}
}
}watchlist.report_readyAPIDnevni izvještaj spreman. Jutarnja procjena svih praćenih vozila je gotova; izvještaj dana čita se jednim pozivom.
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "watchlist.report_ready",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"day": "2026-10-15",
"vehicles": 412,
"alerts": 7,
"report_url": "/v1/watchlist/report?day=2026-10-15"
}
}widget.rating_changedAPIPromijenjena ocjena cijene. Jutarnja procjena je pomjerila ocjenu tražene cijene na vašem widgetu (npr. iz „Fer” u „Povišena”), ili je vozilo iz oglasa prodano.
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "widget.rating_changed",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"widget": {
"object": "widget",
"id": "wgt_7Hq2Lm9PzX4cV1bN8sKd",
"public_id": "k3M9xQ2vTa",
"external_ref": "LAG-0412",
"title": "Volkswagen Golf 7 1.6 TDI Highline",
"status": "active",
"asking_price": 23900,
"value": 22950,
"previous_level": "fair",
"level": "high",
"pct": 4.14,
"day": "2026-10-15"
}
}
}report.createdplatformaNova procjena na platformi. Nova procjena vozila na platformi: vrijednost, raspon, svrha i vaša referenca, da procjena odmah stigne u vaš sistem.
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "report.created",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"report": {
"object": "report",
"id": "cm2x8k1q00001",
"url": "https://enterprise.cifra.ba/valuations/cm2x8k1q00001",
"purpose": "financing",
"reference": "2024/118",
"vehicle": {
"vehicle_type": "car",
"make": "volkswagen",
"model": "golf",
"make_name": "Volkswagen",
"model_name": "Golf",
"year": 2019,
"mileage_km": 98000,
"fuel": "diesel",
"transmission": "manual",
"power_kw": 85
},
"value": 20550,
"low": 19300,
"high": 21900,
"currency": "BAM",
"grade": "A",
"as_of": "2026-10-15",
"created_by": {
"name": "Amra Hodžić",
"email": "amra@firma.ba"
},
"created_at": "2026-10-15T09:41:12.000Z"
}
}
}check.completedplatformaProvjera vozila završena. Provjera oglasa je gotova (nova ili ponovljena): nivo pažnje i signali koje treba provjeriti.
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "check.completed",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"check": {
"object": "vehicle_check",
"id": "cm2x9a7d00004",
"url": "https://enterprise.cifra.ba/check/cm2x9a7d00004",
"vehicle": "Volkswagen Golf 2016",
"listing_url": "https://olx.ba/artikal/61234567",
"level": "elevated",
"headline": "Kilometraža niža nego u ranijem oglasu",
"signals": [
{
"code": "mileage_rollback",
"severity": "high"
},
{
"code": "relisted_often",
"severity": "medium"
}
],
"purpose": "financing",
"reference": "2024/118",
"created_by": {
"name": "Amra Hodžić",
"email": "amra@firma.ba"
},
"checked_at": "2026-10-15T09:52:03.000Z"
}
}
}check.decidedplatformaOdluka o provjeri. Odluka tima o provjerenom vozilu: odobreno, dodatna provjera ili odbijeno, s napomenom.
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "check.decided",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"check": {
"object": "vehicle_check",
"id": "cm2x9a7d00004",
"url": "https://enterprise.cifra.ba/check/cm2x9a7d00004",
"vehicle": "Volkswagen Golf 2016",
"level": "elevated",
"reference": "2024/118",
"decision": "review",
"decision_note": "Tražiti servisnu knjižicu prije odobrenja.",
"decided_by": {
"name": "Emir Kovač",
"email": "emir@firma.ba"
},
"decided_at": "2026-10-15T10:05:27.000Z"
}
}
}bulk.completedplatformaMasovna procjena gotova. Svi redovi liste su procijenjeni: koliko vozila, ukupna vrijednost i veza na listu.
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "bulk.completed",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"batch": {
"object": "valuation_batch",
"id": "cm2xa0b3k0009",
"url": "https://enterprise.cifra.ba/valuations/bulk/cm2xa0b3k0009",
"name": "Lizing portfelj Q3",
"purpose": "financing",
"as_of": "2026-09-30",
"rows": 1240,
"valued": 1228,
"failed": 12,
"total_value": 24118400,
"currency": "BAM",
"created_by": {
"name": "Amra Hodžić",
"email": "amra@firma.ba"
},
"completed_at": "2026-10-15T11:20:45.000Z"
}
}
}usage.threshold_reachedAPIPotrošnja API-ja prešla prag. Ovomjesečne obračunske jedinice su prešle prag koji ste odabrali (npr. 80% ugovorene kvote).
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "usage.threshold_reached",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"month": "2026-10",
"threshold_pct": 80,
"units": 80214,
"quota": 100000,
"resets_at": "2026-11-01T00:00:00.000Z"
}
}webhook.testplatformaTest. Probna poruka koju šaljete sami, da provjerite da adresa prima i provjerava potpis.
Tijelo
{
"id": "evt_2kQ9mX7vR4tL8bN1cZ5p",
"type": "webhook.test",
"created_at": "2026-10-15T06:12:44.000Z",
"livemode": true,
"data": {
"message": "A test event from Cifra."
}
}