Dokumentacioni

URL Bazë

Të gjitha kërkesat API bëhen në URL-në bazë të mëposhtme:

https://api.encarapi.com

Për shembull, për të marrë ofertat:

GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true

Autentifikimi

Autentifikoni kërkesat tuaja duke përdorur një çelës API. Kalojeni si parametër pyetjeje ose përmes kokës Authorization.

# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"

# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEY

Prova 5-ditore

Provoni API-në për 5 ditë me të tria platformat (Encar, KB Chachacha, K Car), përfshirë sinkronizimin e ndryshimeve (7 ditët e fundit), kërkimet në masë (1.000 id në ditë) dhe një parapamje të arkivit (100 shpallje të hequra në ditë). 100.000 rreshta katalogu dhe 2.000 kërkime detajesh gjithsej (maks. 1.000 në ditë). Shkarkimet e referencës (CSV) janë pjesë e planeve me pagesë. Eksporti i plotë i katalogut fillon me planin Business. Pas periudhës provuese, abonimi juaj vazhdon me planin Starter për 149 €/muaj - mund ta anuloni kurdoherë para ditës së 5-të.

Vlerat në rusisht (lang=ru)

Çdo endpoint që pranon lang=en pranon edhe lang=ru: vlerat e shfaqura vijnë në rusisht, gjithçka tjetër mbetet e njëjtë (id, kode, çmime, numra, emra fushash). Një vlerë pa emërtim rusisht kthehet në anglisht. Emërtimet ruse mund të përmirësohen me kohën, ndaj lidhini të dhënat sipas id dhe kodeve, jo sipas emërtimeve.

• Përkthehen: karburanti, kambio, tërheqja, ngjyra e jashtme dhe e brendshme, klasa e karrocerisë, lloji i shitjes, emrat e rajoneve dhe qyteteve, emrat e opsioneve dhe fjalët e përgjithshme në emrat e versioneve (Diesel -> дизель, 7-Seater -> 7 мест). Gjeneratat e modeleve: Carnival 4 Gen -> Carnival 4 поколение. Emrat e markave, modeleve dhe versioneve mbeten me shkronja latine, si në tregjet ruse të makinave.
• Filtrat pranojnë edhe vlerat në rusisht: fuel=дизель, color=белый, region=Сеул, city=Сувон, drivetrain=полный, sell_type=лизинг. Vlerat në anglisht vazhdojnë të funksionojnë.
• /api/enums?lang=ru shton nameRu te çdo vlerë dhe liston vlerat e drivetrain dhe sell_type. /api/nav?lang=ru kthen një DisplayValue në rusisht; Value mbetet kodi anglisht për filtrim. CSV-të e referencës me lang=ru marrin emrin rusisht si kolonë shtesë pas së fundit.
• /api/vehicle/{id}?lang=ru dhe endpoint-i bulk kthejnë në rusisht vlerat spec të Encar, emrat e category dhe emrat e optionsDecoded, kurse njoftimet KB Chachacha si në katalog.
• /api/catalog/export?lang=ru është i njëjti skedar me kolonat e emërtimeve në rusisht; rendi i kolonave dhe të gjitha kolonat e tjera nuk ndryshojnë.
• Nuk përkthehen: raportet e inspektimit, historiku i sigurimit, diagnozat e Encar, historikët e automjeteve Encar, të dhënat e detajuara të K Car, paketat e opsioneve të Encar (tekst i lirë nga njoftimi) dhe endpoint-et e kamionëve dhe ekskavatorëve (me lang=ru përgjigjen në anglisht).

# Russian values, filtered with Russian values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?fuel=дизель&city=Сувон&lang=ru&count=true"

# Filter values with their Russian labels (nameRu)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/enums?lang=ru"

Vlerat në gjermanisht (lang=de)

lang=de funksionon si lang=ru: vlerat e shfaqura vijnë në gjermanisht, gjithçka tjetër mbetet e njëjtë (id, kode, çmime, numra, emra fushash). Një vlerë pa emërtim gjermanisht kthehet në anglisht.

• Përkthehen: karburanti, kambio, tërheqja, ngjyrat, klasa e karrocerisë, lloji i shitjes, emrat e opsioneve dhe emrat e modeleve e versioneve nga tabelat tona gjermane (C-Class -> C-Klasse, 5-Series -> 5er, Carnival 4 Gen -> Carnival 4. Generation, 7-Seater -> 7-Sitzer, Sedan -> Limousine). Rajonet mbajnë emrin anglisht, qytetet mbeten në anglisht.
• Filtrat pranojnë edhe vlerat në gjermanisht: fuel=Benzin, color=Weiß, transmission=Automatik, drivetrain=Allrad, sell_type=Leasingübernahme, model_group=C-Klasse. Emrat gjermanë të modeleve mund të bashkojnë versionet e rifreskuara: Carnival 4. Generation përfshin Carnival 4 Gen dhe The New Carnival 4 Gen.
• Listat, detajet, bulk dhe eksporti funksionojnë si me lang=ru: nameDe te /api/enums dhe /api/taxonomy/option-packages, një DisplayValue gjermanisht te /api/nav, kolona *_de në CSV-të e referencës, catalog_export_de.csv për eksportin. Nuk përkthehet e njëjta gjë si te lang=ru.

# German values, filtered with German values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=Mercedes-Benz&model_group=C-Klasse&fuel=Benzin&lang=de&count=true"

Tre tregje, një API

API ofron shpallje të drejtpërdrejta nga tre tregjet kryesore të makinave të përdorura në Kore. Çdo pikë fundore kthen Encar si parazgjedhje, kështu që integrimet ekzistuese vazhdojnë të funksionojnë pa ndryshime. Dy të tjerat aktivizohen përmes parametrit source.

Zgjedhja e burimeve

source pranohet nga /api/catalog, /api/nav, /api/enums, /api/model-search, /api/catalog/export, /api/catalog/changes dhe CSV-të e taksonomisë.

# All three marketplaces, English values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=all&manufacturer=bmw&fuel=diesel&lang=en&count=true"

# K Car only
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=kcar&manufacturer=hyundai&lang=en"

# One KB Chachacha vehicle
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/vehicle/kbc:12345678?lang=en"

Kur source është vendosur, çdo element ka një fushë Source. ID-të e Encar mbeten numra të thjeshtë. ID-të e KB Chachacha dhe K Car kanë një prefiks (kbc:..., kcar:...) - kalojini të pandryshuara te /api/vehicle/{id}. Me lang=en, emrat e modeleve dhe të versioneve të të tre tregjeve kthehen në anglisht.

Tregtarët shpesh e shpallin të njëjtën makinë në Encar dhe KB Chachacha. Një shpallje e KB Chachacha përputhet me një shpallje aktive të Encar sipas targës koreane ose, kur KB Chachacha nuk publikon targë, sipas muajit të regjistrimit të parë, kilometrazhit dhe çmimit; përputhja rillogaritet disa herë në ditë, pas çdo kalimi në katalogun e Encar dhe të KB Chachacha. Shpalljet e përputhura të KB Chachacha nuk kthehen nga /api/catalog, /api/catalog/export dhe endpoint-et e tjera të katalogut, me ose pa source (as me source=kbc vetëm), kështu që e njëjta makinë nuk shfaqet kurrë dy herë - kur Encar është i përfshirë, ajo kthehet si shpallja e Encar.

Në /api/catalog/changes?source=kbc dhe /api/vehicle/kbc:{id} këto shpallje mbajnë IsDuplicate: true dhe DuplicateOf (ID-ja e shpalljes së Encar, si varg numerik); si te artikujt e Encar, të dyja fushat janë të pranishme vetëm kur janë true. Kur shënimi vendoset ose hiqet, furnizimi i ndryshimeve regjistron një ngjarje updated, changedFields e së cilës përmban duplicate. Që kopja jote lokale të përputhet me /api/catalog, hiq artikujt e KB Chachacha që vijnë me IsDuplicate: true dhe shtoji përsëri kur vjen një përditësim pa këtë fushë.

Furnizimi i ndryshimeve pranon një burim për thirrje (encar, kbc ose kcar) dhe mban një kursor të veçantë për secilin.

Mbulimi sipas tregut

Jo çdo treg publikon çdo fushë.

• KB Chachacha publikon numrin e ulëseve për një pjesë të shpalljeve të tij.
• Detajet e KB Chachacha = elementi i katalogut plus blloku publik i historikut (shenja e aksidentit, dëm total, përmbytje, përdorim komercial, barrë, diagnoza e shasisë dhe e paneleve). Çdo element i KB Chachacha përmban gjithashtu InsuranceClaims: numrin e dëmeve të sigurimit që shfaqet në faqen e shpalljes. Detajet përmbajnë gjithashtu InspectionReportUrl dhe InspectionReportType: fletën e inspektimit që KB Chachacha shfaq për makinën (link = raport në faqen e kompanisë së inspektimit, scan = vetëm imazhe të skanuara në faqen e shpalljes, null = ende e panjohur). Kur InspectionAvailable është true, GET /api/inspection/kbc:{id} e kthen këtë fletë si të dhëna të strukturuara në të njëjtin format si një raport inspektimi i Encar (master, outers, inners, images), bashkë me një bllok source - për rreth dy në çdo pesë shpallje të KB Chachacha me fletë të lidhur.
• K Car nuk ka dokumente të veçanta raporti; numri i aksidenteve, pagesat e sigurimit dhe ndryshimet e pronësisë janë pjesë e detajeve të automjetit.

Filtrimi sipas një fushe që një treg nuk e ofron i përjashton automjetet e atij tregu nga rezultatet. Shembull: frame_clean=true me source=all kthen vetëm shpallje nga Encar dhe K Car.

Pikat Fundore API

Të gjitha pikat fundore të disponueshme për qasje në të dhënat e automjeteve koreane.

Të dhënat e menyve zbritëse (CSV)

Shkarko listat e markave, modeleve dhe badge-ve si CSV, ruaji në cache dhe ndërto prej tyre menytë e tua zbritëse - pa thirrje faceti për çdo klikim dhe pa hartëzim offline. Çdo skedar përfshin një kolonë numërimi dhe skedari badge mban ndarjen sipas tipit të karrocerisë (Coupe / Sedan / Kabriolet).

Pyetjet e Bëra Shpesh