Referenční příručka API

Dokumentace

Dokumentace EnCarAPI. Zjistěte, jak získat přístup k datům korejských aut přes koncové body API. Průvodci integrací a příklady kódu.

Zkušenosti v oboru

Poskytovatel API automobilových dat s mnohaletými zkušenostmi na korejském trhu.

Podpora 7 dní v týdnu

Tým podpory k dispozici 7 dní v týdnu pro pomoc s integrací API.

Služby 24/7

Nepřetržitý monitoring pro spolehlivé doručování dat.

Upozornění na inzeráty v reálném čase

Okamžitý přístup přes API k novým inzerátům aut ihned po jejich zveřejnění.

CSV ke stažení

Stáhněte seznamy značek, modelů a badge jako CSV - uložte je do cache a vynechte živé facetové dotazy.

Flexibilní formáty exportu

Získejte data ve formátech CSV, JSON, Excel a vlastních formátech pro snadnou integraci.

Základní URL

Všechny požadavky na API směřují na následující základní URL:

url

https://api.encarapi.com

Například pro získání nabídek:

http

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

Interaktivní reference API Specifikace OpenAPI

Autentizace

Ověřujte své požadavky pomocí API klíče. Předejte ho jako parametr dotazu nebo přes hlavičku Authorization.

bash

# 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

Pracovní postup integrace

Postupujte podle těchto čtyř kroků pro integraci s EnCarAPI.

Získat dostupné filtry

Získejte všechny možné hodnoty filtrů (značky, modely, konfigurace, barvy atd.)

GET /filters

Získat inzeráty vozidel

Načtěte stránkovaný seznam inzerátů s volitelnými filtry podle značky, modelu, roku, ceny a dalších.

GET /offers?page=1

Sledovat změny

Získejte identifikátor změny pro datum a poté dotazujte přidané, změněné a odstraněné inzeráty.

GET /change_id → GET /changes

Získat detaily inzerátu

Načtěte kompletní data konkrétního inzerátu podle jeho inner_id.

GET /offer?inner_id=...

Koncové body API

Všechny dostupné koncové body pro přístup k datům korejských vozidel.

Data pro rozbalovací nabídky (CSV)

Stáhněte seznamy značek, modelů a badge jako CSV, uložte je do cache a sestavte z nich své rozbalovací nabídky - žádné facetové dotazy při každém kliknutí a žádné offline mapování. Každý soubor obsahuje sloupec s počtem a soubor badge nese rozdělení podle typu karoserie (Coupe / Sedan / Kabriolet).

Stáhněte jednou, uložte do cache - Aktualizováno denně

https://api.encarapi.com/api/taxonomy/makes.csv?api_key=YOUR_KEY

Všechny značky s počty inzerátů

https://api.encarapi.com/api/taxonomy/models.csv?api_key=YOUR_KEY

Všechny kombinace značky a modelu s počty

https://api.encarapi.com/api/taxonomy/badges.csv?api_key=YOUR_KEY

Všechny hodnoty značky, modelu a badge (vč. Coupe / Sedan / Kabriolet) s počty

Pro stažení připojte svůj API klíč - přidejte ?api_key=YOUR_KEY k URL souboru. Soubory jsou chráněné klíčem, bez platného klíče si je nikdo nestáhne.

Aktuálnost dat

Kompletní katalog se obnovuje každý den, nejnovější inzeráty se načítají každé 2 hodiny a prodaná auta se odstraňují každou hodinu.

Jak dlouho ukládat do cache

Hodnoty filtrů, taxonomické CSV a /api/nav: cache na 24 hodin
Inzeráty vozidel (/api/catalog): cache na 1 až 2 hodiny
Detaily vozidla (/api/vehicle/:id): cache na 24 hodin

Inzeráty poskytujte z vlastní databáze a obnovujte je v této kadenci, místo abyste volali živě při každém kliknutí uživatele.

Často kladené otázky

Připraveni začít?

Kontaktujte nás na Telegramu pro získání přístupových údajů k API a začněte přistupovat k datům korejských aut ještě dnes.

Kontakt na Telegramu