Dokumentacja API

Dokumentacja

Dokumentacja EnCarAPI. Dowiedz się, jak uzyskać dostęp do danych koreańskich samochodów przez endpointy API. Przewodniki integracji i przykłady kodu.

Doświadczenie w branży

Dostawca API danych motoryzacyjnych z wieloletnim doświadczeniem na rynku koreańskim.

Wsparcie 7 dni w tygodniu

Zespół wsparcia dostępny 7 dni w tygodniu w zakresie pomocy z integracją API.

Serwis 24/7

Całodobowy monitoring dla niezawodnej dostawy danych.

Powiadomienia o ogłoszeniach w czasie rzeczywistym

Natychmiastowy dostęp przez API do nowych ogłoszeń samochodów w momencie ich publikacji.

Pliki CSV do pobrania

Pobierz listy marek, modeli i badge jako CSV - zapisz je w pamięci podręcznej i pomiń zapytania facetowe na żywo.

Elastyczne formaty eksportu

Otrzymuj dane w formatach CSV, JSON, Excel i niestandardowych formatach dla łatwej integracji.

Bazowy URL

Wszystkie zapytania API kierowane są pod następujący bazowy URL:

url

https://api.encarapi.com

Na przykład, aby pobrać oferty:

http

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

Interaktywna dokumentacja API Specyfikacja OpenAPI

Uwierzytelnianie

Uwierzytelniaj swoje zapytania za pomocą klucza API. Przekaż go jako parametr zapytania lub przez nagłówek 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

Proces integracji

Wykonaj te cztery kroki, aby zintegrować się z EnCarAPI.

Pobierz dostępne filtry

Pobierz wszystkie możliwe wartości filtrów (marki, modele, konfiguracje, kolory itp.)

GET /filters

Pobierz ogłoszenia pojazdów

Pobierz stronicowaną listę ogłoszeń z opcjonalnymi filtrami według marki, modelu, roku, ceny i innych.

GET /offers?page=1

Śledź zmiany

Pobierz identyfikator zmiany dla daty, a następnie odpytuj o dodane, zmienione i usunięte ogłoszenia.

GET /change_id → GET /changes

Pobierz szczegóły ogłoszenia

Pobierz pełne dane konkretnego ogłoszenia według jego inner_id.

GET /offer?inner_id=...

Endpointy API

Wszystkie dostępne endpointy do uzyskiwania danych koreańskich pojazdów.

Dane list rozwijanych (CSV)

Pobierz listy marek, modeli i badge jako CSV, zapisz je w pamięci podręcznej i zbuduj z nich swoje listy rozwijane - żadnych zapytań facetowych przy każdym kliknięciu i żadnego mapowania offline. Każdy plik zawiera kolumnę z liczbą, a plik badge niesie podział według typu nadwozia (Coupe / Sedan / Kabriolet).

Pobierz raz, zapisz w pamięci podręcznej - Aktualizowane codziennie

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

Wszystkie marki z liczbą ogłoszeń

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

Wszystkie kombinacje marki i modelu z liczbami

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

Wszystkie wartości marki, modelu i badge (w tym Coupe / Sedan / Kabriolet) z liczbami

Dodaj swój klucz API, aby pobrać - dołącz ?api_key=YOUR_KEY do adresu URL pliku. Pliki są chronione kluczem, bez ważnego klucza nikt ich nie pobierze.

Aktualność danych

Pełny katalog jest odświeżany codziennie, najnowsze ogłoszenia są pobierane co 2 godziny, a sprzedane samochody są usuwane co godzinę.

Jak długo przechowywać w pamięci podręcznej

Wartości filtrów, taksonomiczne pliki CSV i /api/nav: pamięć podręczna na 24 godziny
Ogłoszenia pojazdów (/api/catalog): pamięć podręczna na 1 do 2 godzin
Szczegóły pojazdu (/api/vehicle/:id): pamięć podręczna na 24 godziny

Udostępniaj ogłoszenia z własnej bazy danych i odświeżaj je w tym rytmie, zamiast wykonywać zapytania na żywo przy każdym kliknięciu użytkownika.

Najczęściej zadawane pytania

Gotowy, aby zacząć?

Skontaktuj się z nami na Telegramie, aby uzyskać dane dostępowe do API i rozpocząć dostęp do danych koreańskich samochodów już dziś.

Kontakt na Telegramie