APIProcjene
Vaš šifarnik
Portali s vlastitim šifarnikom marki, modela i atributa šalju procjene svojim šiframa; Cifra ih prevodi.
Ako vaš sistem vozila vodi po svom šifarniku (marke, modeli, opcije atributa), ne morate ga prevoditi na Cifrin. Uz dogovoreni taxonomy, POST /v1/valuations prima vašu šifru modela i atribute oglasa onako kako ih čuvate; Cifra ih prevodi i u odgovoru kaže šta je pročitala. Šifarnik se uključuje dogovorom: pošaljete nam svoje datoteke marki/modela i atributa, mi ih mapiramo i pregledamo.
Zahtjev
{
"taxonomy": "vas_portal",
"model": "Volkswagen_Golf",
"title": "VW Golf 7 2.0 TDI Highline",
"attributes": {
"YearOfProduction": 2017,
"Mileage": 182000,
"EnginePowerKW": 110,
"EngineDisplacement": "Vehicles_Cars_EngineDisplacement_20",
"Fuel": "Vehicles_Cars_Fuel_DSL",
"Transmission": "Vehicles_Cars_Transmission_Manual",
"Security": [
"Vehicles_Cars_Security_ABS",
"Vehicles_Cars_Security_ESP"
]
},
"city": "Banja Luka",
"seller_type": "dealer"
}Sve ostalo je kao u običnoj procjeni: include, as_of, km_per_year, valuation_model, masovna procjena (POST /v1/valuations/batch, stavke mogu miješati oba oblika) i widgeti, koji se objavljuju s valuation_id iz odgovora.
taxonomystringobaveznodo 40 znakovaVaš šifarnik, kako je dogovoren s Cifrom, npr.
mungos. S njimmodeliattributesšaljete vašim šiframa.modelstringobaveznodo 120 znakovaŠifra modela iz vašeg šifarnika, npr.
Volkswagen_Golf.brandstringopcionalnodo 120 znakovaŠifra marke iz vašeg šifarnika, npr.
Volkswagen. Nije obavezna; ako je pošaljete, mora odgovarati modelu.categorystringopcionalnodo 80 znakovaŠifra vaše kategorije, npr.
Vehicles_Cars. Podrazumijevano kategorija automobila.titlestringopcionalnodo 300 znakovaNaslov oglasa. Iz njega Cifra prepoznaje generaciju i verziju kad je vaša šifra šira od našeg modela (Golf → Golf 7 GTI), i model kad je šifra „Drugi”/„Ostalo”.
attributesobjectopcionalnoAtributi oglasa vašim šiframa: objekat
{ "Fuel": "Vehicles_Cars_Fuel_DSL", "EnginePowerKW": 110, "Security": [ … ] }ili lista[{ "code": "Fuel", "value": … }]. Opcije šaljete šifrom (tačno, s velikim i malim slovima) ili nazivom.yearintegeropcionalnonajmanje 1950Godište, ako nije u atributima (
YearOfProduction).mileage_kmintegeropcionalno0 – 2.000.000Kilometraža, ako nije u atributima (
Mileage).conditionenumopcionalnoStanje:
used(podrazumijevano) ilinew.usednewseller_typeenumopcionalnoKo prodaje: privatna osoba ili salon.
privatedealercitystringopcionalnodo 80 znakovaGrad u BiH, npr.
SarajevoiliBanja Luka. Regionalna potražnja pomjera cijenu.as_ofdateopcionalnoDatum procjene (
YYYY-MM-DD), od 2015-01-01 do danas: vrijednost kakva je bila tog dana, npr. na dan štete. Podrazumijevano danas (UTC).includeenum[]opcionalnodo 3 stavkeDodaci odgovoru:
explanation(obračun cijene),forecast(vrijednost kroz 6–36 mjeseci),comparables(slična vozila u prodaji). Bez polja:explanationiforecast;[]vraća samo vrijednost.explanationforecastcomparableskm_per_yearintegeropcionalno0 – 150.000Koliko će vozilo prelaziti godišnje, za prognozu. Podrazumijevano: njegov dosadašnji prosjek.
valuation_modelenumopcionalnoauto(podrazumijevano): vaš model kompanije kad je u upotrebi, inače standardni;standard: uvijek standardni tržišni model.autostandard
Šta je Cifra pročitala
Odgovor je obična procjena s dodatnim poljem interpreted: naš model i polja koja smo izvukli iz vaših atributa. ignored navodi atribute ili opcije koje nismo razumjeli; procjena se svejedno napravi, ali ih vrijedi provjeriti.
{
"taxonomy": "vas_portal",
"code": "Volkswagen_Golf",
"make": "volkswagen",
"model": "golf_7",
"model_from": "title",
"fields": {
"year": 2017,
"mileage_km": 182000,
"power_kw": 110,
"engine_cc": 2000,
"fuel": "diesel",
"transmission": "manual"
},
"equipment": [
"abs",
"esp"
],
"ignored": []
}model_from | Kako je model izabran |
|---|---|
code | Vaša šifra je tačno jedan naš model. |
title | Šifra je šira od našeg modela (npr. Golf, a mi razlikujemo Golf 6, Golf 7, Golf 7 GTI) ili je „Drugi”; model je pročitan iz naslova. |
year_power | Naslov ga ne imenuje; izabran je po godištu, gorivu i snazi među modelima koje šifra pokriva. |
code_default | Ni naslov ni podaci ne razlikuju verziju; vrednuje se kao opšti model. |
Atributi
- Atribute šaljete kao objekat (
{ "Fuel": "…" }) ili kao listu ([{ "code": "Fuel", "value": "…" }]); višestruki izbor kao niz. - Opcije šaljete šifrom, tačno kako je u vašem šifarniku — velika i mala slova se razlikuju — ili nazivom („Dizel”).
- Godište i kilometražu možete poslati i kao
yearimileage_km; tada imaju prednost. - Oprema se svodi na Cifrin rječnik, pa ista oprema vrijedi isto kao u oglasima iz kojih model uči. Atributi koje model ne koristi (boja enterijera, gume, registracija…) se prihvataju i preskaču.
Kad vozilo ne možemo procijeniti
| Kod (422) | Značenje |
|---|---|
unknown_partner_code | Šifra nije u vašem šifarniku kod nas. Zabilježena je; čim je mapiramo, radi. |
unsupported_model | Marka ili model koji Cifra ne procjenjuje (nema ga na našem tržištu), ili šifra čeka naš pregled (status: review). |
model_ambiguous | Šifra pokriva više naših modela (generacije, motori), a ni naslov ni godište i snaga ih ne razlikuju. Pošaljite title. |
model_not_identified | Šifra „Drugi/Ostalo”, a naslov ne imenuje model koji poznajemo. |
vehicle_damaged, not_driveable | Oštećeno ili nevozno vozilo: tržišna vrijednost važi za ispravno vozilo, pa ga ne procjenjujemo. |
unknown_taxonomy, taxonomy_not_allowed | Nepoznat šifarnik, ili pripada drugoj kompaniji. |