Historia serwisowa od producenta – przez API
Jedno uwierzytelnione wywołanie zwraca w ustrukturyzowanym JSON-ie historię serwisową pojazdu z systemu producenta: daty, odczyty przebiegu, warsztat, który wykonał prace, i ich zakres. Wyświetlaj ją w ogłoszeniach, wycenach albo w procesie przyjmowania aut w rozliczeniu.
Dostęp ustalamy bezpośrednio z tobą – podaj nam wolumen i zastosowanie, a zaproponujemy stawkę.
{
"success": true,
"data": {
"vin": "WBA8E9G50GNT12345",
"vehicle": {
"make": "BMW",
"model": "Seria 3",
"yearOfManufacture": 2018,
"fuelType": "Diesel"
},
"serviceHistory": [
{
"dateOfServiceEvent": "2024-01-15",
"mileageObserved": 71400,
"mileageUnit": "km",
"serviceProvider": "Autoryzowany serwis BMW Warszawa",
"serviceType": "Wymiana oleju",
"serviceActions": [
"Olej silnikowy i filtr",
"Filtr kabinowy"
]
}
],
"hasServiceHistory": true
}
}
Dla kogo to jest
Jeśli historia serwisowa pojazdu wpływa na decyzje twoich użytkowników, jej miejsce jest w twoim produkcie, a nie w osobnej zakładce.
Serwisy ogłoszeniowe i remarketing
Pokazuj historię serwisową bezpośrednio w ogłoszeniu. Kupujący licytują pewniej, a sprzedający odpowiadają na mniej pytań o przeszłość auta.
Grupy dealerskie i dostawcy oprogramowania
Włącz dane serwisowe do wyceny, zarządzania stanem magazynowym albo systemu DMS, żeby przy przyjmowaniu auta w rozliczeniu nikt nie musiał zgadywać.
Wyceny, finansowanie i ubezpieczenia
Udokumentowana historia serwisowa realnie wpływa na wartość rezydualną i ryzyko. Pobieraj ją dokładnie wtedy, gdy zapada decyzja.
Floty, leasing i wynajem
Porównaj to, co zapisała sieć serwisowa producenta, z własnym rejestrem obsługi, zanim pojazd opuści flotę.
Co otrzymujesz
Przewidywalną odpowiedź JSON, którą możesz wyświetlić bez przeróbek. Bez scrapowania, bez parsowania PDF-ów i bez naszej marki w danych.
- Data każdej zapisanej obsługi serwisowej
- Przebieg odczytany w danym momencie, wraz z jednostką
- Warsztat lub dealer, który wykonał prace
- Rodzaj obsługi serwisowej i poszczególne zapisane czynności
- Dane pojazdu – marka, model, rocznik, paliwo i silnik
POST /api/v1/lookup
Authorization: Bearer fsh_live_…
{ "vin": "WBA8E9G50GNT12345" }Zapytanie – wysyłasz tylko numer VIN
{
"success": true,
"data": {
"vin": "WBA8E9G50GNT12345",
"vehicle": {
"make": "BMW",
"model": "Seria 3",
"yearOfManufacture": 2018,
"fuelType": "Diesel"
},
"serviceHistory": [
{
"dateOfServiceEvent": "2024-01-15",
"mileageObserved": 71400,
"mileageUnit": "km",
"serviceProvider": "Autoryzowany serwis BMW Warszawa",
"serviceType": "Wymiana oleju",
"serviceActions": [
"Olej silnikowy i filtr",
"Filtr kabinowy"
]
}
],
"hasServiceHistory": true
}
}
Przykładowa odpowiedź – skrócona
Jak wygląda integracja
- 1
Powiedz nam, czego potrzebujesz
Wolumen, rynki i sposób prezentacji danych. Odpowiemy stawką i potwierdzimy pokrycie dla marek, którymi faktycznie handlujesz.
- 2
Wydajemy dane dostępowe
Klucz i sekret do podpisywania, przypisane do twojego konta. Opcjonalnie ograniczone do twoich adresów wychodzących, z limitem zapytań dopasowanym do wolumenu.
- 3
Czekasz na odpowiedź albo dostajesz callback
Wyślij zapytanie i poczekaj na odpowiedź albo utwórz zadanie i odbierz podpisany callback, gdy historia będzie gotowa. Oba tryby działają od pierwszego dnia.
Pokrycie – opisane uczciwie
Pokrycie to to, co da się pobrać, a nie to, jak często coś wraca. Obie liczby są dla ciebie ważne, więc oto rozróżnienie, którego się trzymamy.
Obsługujemy 44 marki od rocznika 2012 na rynkach europejskich. Starsze pojazdy czasem też zwracają wpisy, ale nigdy tego nie obiecujemy.
Szczegółowość zależy od producenta. Niektórzy zwracają pełny opis prac i warsztat, inni tylko samo zdarzenie i przebieg. Zanim się zobowiążesz, powiemy ci, jak to wygląda dla twoich marek.
To, jak często wracają wpisy, zależy od pojazdów, które sprawdzasz, a nie od źródła. Pula dostawczaków poflotowych, serwisowanych poza siecią ASO, zwraca znacznie mniej niż pula aut od klientów indywidualnych.
Co naprawdę oznacza brak danych
Brak wpisu oznacza, że sieć producenta nie ma nic o tym pojeździe – a nie, że pojazd nigdy nie był serwisowany. Prace niezależnych warsztatów są dla tych systemów niewidoczne. Każdy tekst, który pokazujesz swoim użytkownikom, powinien to jasno mówić – pomożemy ci go dobrze sformułować.
Gotowe na ruch produkcyjny
Uwierzytelnianie tokenem
Dane dostępowe typu Bearer, przechowywane jako hash i odwoływalne dla każdego klucza osobno.
Podpisane callbacki
Każdy callback ma podpis HMAC-SHA256 i znacznik czasu i jest ponawiany według stałego harmonogramu, dopóki nie potwierdzisz odbioru.
Bezpieczne ponowienia
Wyślij klucz idempotencji, a powtórzone zapytanie zwróci pierwotną odpowiedź. Nigdy nie płacisz dwa razy.
Lista dozwolonych adresów
Opcjonalnie ogranicz klucz do własnych zakresów adresów wychodzących, żeby wykradzione dane dostępowe nie działały nigdzie indziej.
Limity dopasowane do ciebie
Domyślny limit jest celowo niski. Twój podnosimy do wolumenu z umowy.
Specyfikacja czytelna maszynowo
Opis w OpenAPI 3.1, dzięki któremu twój zespół wygeneruje klienta, zamiast pisać go ręcznie.
Jak działa cennik
Prosto i według wolumenu. Wycenę przygotujemy, gdy będziemy wiedzieć, co i w jakiej ilości chcesz sprawdzać.
- Płacisz za wynik, nie za zapytanie
- Wyszukiwanie, które nic nie znajdzie, jest bezpłatne
- Stawka spada wraz ze wzrostem miesięcznego wolumenu
- Faktura co miesiąc, bez minimalnego okresu umowy
Nie publikujemy cennika, bo właściwa stawka zależy od wolumenu, rynku i struktury marek. Podaj nam te trzy rzeczy, a szybko dostaniesz konkretną kwotę.
Poproś o wycenęPorozmawiajmy o dostępie do API
Opisz w kilku zdaniach planowaną integrację, a odpowiemy szczegółami pokrycia i stawką. Każdą wiadomość czytamy osobiście.
Najczęstsze pytania
Czy dane są oznaczone waszą marką?
Nie. Odpowiedź zawiera dane pojazdu i nic naszego – bez logo, bez nazwy, bez linku zwrotnego. Wyświetlasz je jako własne.
Ile trwa jedno wyszukiwanie?
Historia jest pobierana na żywo z sieci producenta, więc licz się z dziesiątkami sekund, a nie milisekundami. Przy dużym ruchu tworzysz zadanie, a my wywołujemy twój callback, gdy wynik będzie gotowy – twoja aplikacja nie musi na nic czekać.
Czy możemy przechowywać pobrane dane?
Przechowywanie i ponowne wyświetlanie ustalamy w umowie, a nie zakładamy z góry. Ma to największe znaczenie, jeśli wielokrotnie wystawiasz ten sam pojazd – przed podpisaniem dokładnie opiszemy, co jest dozwolone.
Co się dzieje, gdy wyszukiwanie nic nie znajdzie?
Dostajesz jednoznaczny pusty wynik, za który nie płacisz. Prawdziwy brak danych i awaria po stronie dostawcy są zgłaszane inaczej, więc nigdy nie obciążysz swoich użytkowników za naszą awarię.
Czy możemy najpierw przetestować?
Tak. Zwykle zaczynamy od małego, płatnego proof of concept, którego koszt odliczamy od pierwszej faktury – dzięki temu mierzysz skuteczność na własnych pojazdach, a nie na naszych.
Czy podpisujecie umowę powierzenia przetwarzania danych?
Tak. Umowy enterprise obejmują ochronę danych, dozwolone sposoby wyświetlania i poziom wsparcia. Jeśli wolisz, możemy pracować na twoich dokumentach.
Chcesz zobaczyć dane?
Podaj nam wolumen i rynki, na których działasz. Dostaniesz szczegóły pokrycia i stawkę, a nie serię e-maili sprzedażowych.
Poproś o dostęp do API