Dokumentacioni
Dokumentacioni i EnCarAPI. Mësoni si të qaseni në të dhënat e makinave koreane përmes pikave fundore të drejtpërdrejta API. Udhëzues integrimi dhe shembuj kodi.
Përvojë në Industri
Ofrues i API-së së të dhënave të automjeteve me vite përvojë në tregun korean.
Mbështetje 7-Ditore
Ekipi i mbështetjes i disponueshëm 7 ditë në javë për ndihmë me integrimin API.
Shërbim 24/7
Monitorim gjatë gjithë kohës për dërgim të besueshëm të dhënash.
Njoftime Listash në Kohë Reale
Merrni qasje të menjëhershme API në listat e reja të makinave sapo publikohen.
Shkarkime CSV
Shkarko listat e markave, modeleve dhe badge-ve si CSV - ruaji në cache dhe anashkalo thirrjet faceti të drejtpërdrejta.
Formate Eksporti Fleksibël
Merrni të dhëna në CSV, JSON, Excel dhe formate të personalizuara për integrim të lehtë.
URL Bazë
Të gjitha kërkesat API bëhen në URL-në bazë të mëposhtme:
https://api.encarapi.comPër shembull, për të marrë ofertat:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=trueAutentifikimi
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_KEYRrjedha e Integrimit
Ndiqni këto katër hapa për t'u integruar me EnCarAPI.
Merr Filtrat e Disponueshme
Merrni të gjitha vlerat e mundshme të filtrave (marka, modele, konfigurime, ngjyra, etj.)
GET /filtersMerr Listat e Automjeteve
Merrni lista të faqëzuara me filtra opsionalë për markën, modelin, vitin, çmimin dhe më shumë.
GET /offers?page=1Ndiq Ndryshimet
Merrni një ID ndryshimi për një datë, pastaj kontrolloni për lista të shtuara, të ndryshuara dhe të hequra.
GET /change_id â GET /changesMerr Detajet e ListĂ«s
Merrni detajet e plota për një listë specifike sipas inner_id të saj.
GET /offer?inner_id=...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).
Shkarko një herë, ruaje në cache - Përditësuar çdo ditë
TĂ« gjitha markat me numrin e shpalljeve
TĂ« gjitha kombinimet e markave dhe modeleve me numra
Të gjitha vlerat e markës, modelit dhe badge-it (përfshirë Coupe / Sedan / Kabriolet) me numra
Shto çelësin tënd API për ta shkarkuar - shto ?api_key=YOUR_KEY te URL-ja e skedarit. Skedarët janë të mbrojtur me çelës, askush nuk mund t'i shkarkojë pa një çelës të vlefshëm.
Freskia e të dhënave
Katalogu (çmimet, kilometrazhi, njoftimet e reja dhe të shitura) rifreskohet rreth çdo 5 orë, plus një kalim më i thelluar një herë në ditë. Detajet e mjetit (specifikimet, fotot, gjendja, raporti i aksidentit) ndjekin ciklin e vet, më të ngadaltë - zakonisht brenda 3 javësh nga një ndryshim, më shpejt nëse katalogu sinjalizon diçka të rëndësishme.
PĂ«rfshirja e katalogut
GET /api/catalog pĂ«rfshin vetĂ«m shpalljet e shitjes standarde (lloji i shitjes âìŒë°â i Encar). Marrjet pĂ«rsipĂ«r tĂ« qirasĂ« (â늏ì€â) dhe shpalljet me qira (âë ížâ) nuk pĂ«rzihen kĂ«tu - çmimi i tyre caktohet me pagesĂ« mujore dhe jo me çmim blerjeje, gjĂ« qĂ« do ta shtrembĂ«ronte fushĂ«n Price. PĂ«r kĂ«to pĂ«rdor GET /api/catalog/leasing.
Sa kohë të ruhet në cache
- Vlerat e filtrave, CSV-të taksonomike dhe /api/nav: ruaj në cache për 24 orë
- Shpalljet e mjeteve (/api/catalog): ruaj në cache për 4 deri në 6 orë
- Detajet e mjetit (/api/vehicle/:id): ruaj në cache për 24 orë
Ky është modeli Starter: shërbeji shpalljet nga baza jote e të dhënave dhe rifreskoji me këtë ritëm, në vend që të bësh thirrje live për çdo klikim të përdoruesit. Në këtë plan ka një kufi ditor të vëllimit të katalogut - ai është menduar për kërkesa live, jo për të mbajtur një kopje lokale të plotë.
Ke nevojë për një kopje lokale të plotë në vend të kësaj?
Planet Business dhe Scale përfshijnë GET /api/catalog/export (një pamje e plotë ditore CSV që nuk llogaritet në kufirin ditor) dhe GET /api/catalog/changes?since=... (shpallje të shtuara, të përditësuara, të riparaqitura dhe të hequra që nga sinkronizimi yt i fundit). Mbush bazën tënde të të dhënave nga eksporti një herë, pastaj pyet për ndryshimet për ta mbajtur të përditësuar - pa rimarrë më gjithë katalogun. Scale gjithashtu heq plotësisht kufirin ditor të vëllimit të katalogut.
Shpallje dublikatë
Shitësit koreanë shpesh e postojnë të njëjtën makinë fizike dy herë nën ID shpalljesh të ndryshme për më shumë dukshmëri - i njëjti çmim, kilometrazh, viti i modelit dhe modeli/paketa. Ne i zbulojmë këto dhe i shënojmë kopjet shtesë me IsDuplicate: true dhe DuplicateOf: <ID e shpalljes origjinale> te artikulli i katalogut; shpallja origjinale mbetet e pashënuar. Dublikatët shënohen, nuk hiqen, kështu që vendos vetë si t'i trajtosh - kalo exclude_duplicates=true te /api/catalog ose /api/catalog/leasing që t'i filtrosh në server.
Pyetjet e BĂ«ra Shpesh
Gati për të Filluar?
Na kontaktoni në Telegram për të marrë kredencialet tuaja API dhe filloni të qaseni në të dhënat e makinave koreane sot.