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

POST /v1/valuations
{
  "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 znakova

    Vaš šifarnik, kako je dogovoren s Cifrom, npr. mungos. S njim model i attributes š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 znakova

    Naslov 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”.

  • attributesobjectopcionalno

    Atributi 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 1950

    Godište, ako nije u atributima (YearOfProduction).

  • mileage_kmintegeropcionalno0 – 2.000.000

    Kilometraža, ako nije u atributima (Mileage).

  • conditionenumopcionalno

    Stanje: used (podrazumijevano) ili new.

    usednew
  • seller_typeenumopcionalno

    Ko prodaje: privatna osoba ili salon.

    privatedealer
  • citystringopcionalnodo 80 znakova

    Grad u BiH, npr. Sarajevo ili Banja Luka. Regionalna potražnja pomjera cijenu.

  • as_ofdateopcionalno

    Datum 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 stavke

    Dodaci odgovoru: explanation (obračun cijene), forecast (vrijednost kroz 6–36 mjeseci), comparables (slična vozila u prodaji). Bez polja: explanation i forecast; [] vraća samo vrijednost.

    explanationforecastcomparables
  • km_per_yearintegeropcionalno0 – 150.000

    Koliko će vozilo prelaziti godišnje, za prognozu. Podrazumijevano: njegov dosadašnji prosjek.

  • valuation_modelenumopcionalno

    auto (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.

interpreted
{
  "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_fromKako je model izabran
codeVaš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_powerNaslov ga ne imenuje; izabran je po godištu, gorivu i snazi među modelima koje šifra pokriva.
code_defaultNi 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 year i mileage_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_modelMarka 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_driveableOštećeno ili nevozno vozilo: tržišna vrijednost važi za ispravno vozilo, pa ga ne procjenjujemo.
unknown_taxonomy, taxonomy_not_allowedNepoznat šifarnik, ili pripada drugoj kompaniji.
Cifra namjerno ne pogađa: procjena koja ide u javni widget mora biti za tačan model. Vozilo s greškom 422 jednostavno prikažite bez widgeta.
Kad dodate nove modele u svoj šifarnik, pošaljite nam novu datoteku. Šifre koje API vidi, a nisu u njoj, svakako bilježimo i mapiramo.