PRZEWODNIK INTEGRACJI

Sprawdź pojazdy ze swojego serwera.

Uwierzytelnianie

Utwórz konto i skopiuj hasło z Mojego konta. Używać Authorization: Bearer TU_CLAVE lub nagłówek X-API-Key. Nie umieszczaj kluczy w adresach URL, publicznym kodzie HTML ani JavaScript przeglądarki.

curl "https://TU_DOMINIO/api/search.php?brand=Abarth&model=124&y1=2018&y2=2018&limit=10" \
  -H "Authorization: Bearer TU_CLAVE"

Filtry i paginacja

Parametr	Użyj
brand / brand_id	Dokładna marka lub identyfikator.
model / model_id	Część nazwy lub identyfikatora.
cc, kw, cv	Dokładne wartości liczbowe.
y1, y2	Nakładają się na przedział lat. Dla konkretnego roku użyj obu z tą samą wartością.
limit	Od 1 do 100; domyślnie 50.
offset	Od 0. Użyj next_offset, gdy has_more ma wartość true.

{
  "results": [
    {"id": 1, "brand": "Abarth", "model": "124 Spider",
     "cc": 1368, "kw": 125, "cv": 170, "engine_code": "552 53 268",
     "year_start": 2018, "year_end": 2019, "fuel": null, "body": null}
  ],
  "count": 1, "limit": 10, "offset": 0,
  "has_more": false, "next_offset": null, "tokens_remaining": 99
}

Ilustrujący przykład formatu. Konkretne wyniki zależą od katalogu.

Filtry zaktualizowanego katalogu

generation, fuel, technology, engine: Dokładne wartości tekstowe.

fuel=Diésel&technology=TDI&engine=BKD

Równowaga i ograniczenia

Każde 200 odpowiedzi zużywa zapytanie do bazy danych, nawet jeśli nie ma żadnych dopasowań. Błędy nie zużywają równowagi. Limit minut jest współdzielony pomiędzy kluczami tego samego użytkownika i jest sprawdzany w ciągu ostatnich 60 sekund.

W pierwszej kolejności wydawane są bieżące, miesięczne zapytania do bazy danych, a następnie dodatkowe, zakupione. Doładowania są zachowywane przy odnawianiu miesiąca. Bezpłatne plany odnawiają się po użyciu lub przez cron; Plany płatności są uzupełniane dopiero po zweryfikowaniu płatności. Jeśli okres wygaśnie, Twoje miesięczne saldo nie będzie już dostępne.

HTTP	Znaczenie
400	Nieprawidłowe filtry lub zakres lat.
401	Brak klucza API.
402	Brak dostępnych zapytań do bazy danych.
403	Nieaktywny klucz lub subskrypcja bez dostępu.
429	Limit na minutę; Ponów próbę po: 60.
500 / 503	Błąd usługi lub połączenia.

Zakres danych

Rok końcowy o wartości null oznacza, że rok końcowy nie jest znany i podczas filtrowania jest traktowany jako zakres otwarty. Nie jest to dowodem na to, że dany model jest nadal produkowany. Odwrócone zakresy są wykluczone do czasu sprawdzenia. Paliwo, nadwozie i inne pola nie mogą być zgłaszane. Dane te nie gwarantują kompatybilności części zamiennej: powiązanie to musi zostać dostarczone i potwierdzone przez sklep.