API historii serwisowej dla dealerów i firm

Zlecaj sprawdzenia historii serwisowej prosto ze swoich systemów. Wyślij numer VIN, a w ustrukturyzowanym formacie JSON dostaniesz wizyty zarejestrowane przez sieć dealerską producenta. 16,99 zł za zapytanie, które zwraca wpisy, albo 12,99 zł w abonamencie miesięcznym za 259,99 zł miesięcznie.

  • Zapytanie po numerze VIN
  • Wpisy z sieci dealerskiej producenta dla 38 marek
  • 16,99 zł za zapytanie z wpisami, płatne z przedpłaconego salda; 12,99 zł w abonamencie miesięcznym
  • Nie ma wpisów, nie ma opłaty

Co możesz zbudować

Pokaż historię serwisową producenta tam, gdzie Twój zespół i Twoi kupujący już zaglądają, bez ręcznego zlecania sprawdzeń.

Przyjęcie na stan i DMS

Sprawdzaj każde auto brane w rozliczeniu już przy wycenie: wpisy serwisowe trafiają automatycznie do Twojego systemu DMS albo narzędzia do zarządzania stanem.

Strona internetowa i ogłoszenia

Pokazuj sprawdzoną historię serwisową na stronach swoich aut: liczbę wizyt w ASO, datę ostatniego serwisu i przebieg.

Platformy aukcyjne i remarketingowe

Dodaj historię serwisową producenta do strony każdego auta na aukcji, żeby kupujący widzieli ją przed rozpoczęciem licytacji.

Floty i zwroty z leasingu

Po zakończeniu umów sprawdzaj historię serwisową wszystkich zwracanych aut za jednym razem, bez wpisywania każdego auta osobno.

Jak to działa

  1. Uzyskaj klucz API

    Dostęp do API jest częścią zatwierdzonego konta firmowego. Napisz do nas, a go włączymy. Potem doładowujesz saldo i tworzysz klucze w panelu konta firmowego. Abonament miesięczny jest opcjonalny.

  2. Wyślij numer VIN

    Jedno uwierzytelnione żądanie na auto, z Twoim kluczem w nagłówku x-api-key.

  3. Odbierz ustrukturyzowane wpisy

    Każdy serwis w ASO wraca z datą, przebiegiem, dealerem, który go wykonał, i zakresem prac, a do tego z linkiem do pełnego raportu ServiceStamp.

Przykładowe żądanie i odpowiedź

Jedno żądanie na auto. Każdy serwis w ASO zarejestrowany przez producenta wraca w service_events.

Bazowy adres URL: https://api.servicestamp.pl/v1. Te same endpointy odpowiadają też pod adresem https://servicestamp.pl/api/v1.

Żądanie

curl -G "https://api.servicestamp.pl/v1/service-history" \
  -d vin=WVWZZZAUZKP508214 \
  -H "x-api-key: YOUR_API_KEY"

Odpowiedź

{
  "success": true,
  "result": {
    "report_id": "rpt_8Kq2vX",
    "report_url": "https://servicestamp.pl/report/rpt_8Kq2vX",
    "vehicle_identification_number": "WVWZZZAUZKP508214",
    "registration_mark": null,
    "vehicle": { "make": "Volkswagen", "model": "Golf", "year": 2019, "fuel_type": "Petrol" },
    "service_events": [
      {
        "date_of_service_event": "2024-09-12",
        "service_provider": "Autoryzowany serwis Volkswagen, Poznań",
        "mileage_observed": 45230,
        "mileage_unit": "km",
        "service_type": "serviceVisit",
        "service_items": [
          { "item_type": "Service", "item_description": "Wymiana oleju silnikowego i filtra" },
          { "item_type": "Inspection", "item_description": "Kontrola stanu pojazdu" }
        ]
      }
    ]
  }
}

Co zawiera każdy wpis

PoleZnaczenie
date_of_service_eventKiedy wykonano serwis
service_providerDealer, który wykonał prace
mileage_observed / mileage_unitPrzebieg podczas wizyty w serwisie, w km albo mi
service_typeRodzaj wizyty w serwisie
service_itemsKażda wykonana czynność, z jej kategorią
report_urlPełny raport ServiceStamp z historią przebiegu, do udostępnienia kupującym albo pobrania jako PDF

Wartość, której nie mamy, wraca jako null i nigdy nie jest pomijana: niektórzy producenci nie podają jednostki przebiegu ani kategorii czynności.

Kody odpowiedzi

Płacisz tylko wtedy, gdy wracają wpisy.

KodZnaczenie
200Znaleziono wpisy. Z Twojego salda API pobieramy 16,99 zł, a w abonamencie miesięcznym 12,99 zł.
202System producenta wciąż pracuje. Spróbuj ponownie po czasie podanym w nagłówku Retry-After. Płacisz tylko wtedy, gdy wracają wpisy.
204Producent nie ma żadnych wpisów serwisowych dla tego auta. Nic nie pobieramy.
400Nieprawidłowy numer VIN.
401Brak klucza API, klucz jest nieprawidłowy albo został unieważniony.
402Saldo API się wyczerpało. Doładuj je w panelu konta firmowego.
403Dostęp do API jest wyłączony albo konto firmowe nie jest aktywne.
404Nie znaleziono auta o tym numerze VIN. Nic nie pobieramy.
429Za dużo żądań. Zwolnij i spróbuj ponownie po czasie podanym w nagłówku Retry-After.
503Nie udało nam się zrealizować zapytania. Spróbuj ponownie później. Nic nie pobieramy.

Cennik: płacisz za zapytanie, mniej w abonamencie miesięcznym

Zapytania są opłacane z przedpłaconego salda, po 16,99 zł za każde i tylko wtedy, gdy wracają wpisy. Opcjonalny abonament miesięczny za 259,99 zł miesięcznie obniża tę cenę do 12,99 zł, opłaca się od 65 zapytań miesięcznie i możesz go anulować w każdej chwili. Saldo doładujesz w panelu kwotą od 200,00 zł.

PozycjaCena
Zapytanie z wpisami, bez abonamentu16,99 zł
Abonament miesięczny API (opcjonalny)259,99 zł miesięcznie
Zapytanie z wpisami, w abonamencie miesięcznym12,99 zł

Nie ma wpisów, nie ma opłaty

Zapytanie, które nie znajdzie żadnych wpisów serwisowych producenta, nic nie kosztuje, dokładnie tak jak sprawdzenia, które zlecasz w panelu konta firmowego.

Ponowne próby są bezpłatne

Odpowiedź „w trakcie przetwarzania” nigdy nie jest płatna. Zapytaj ponownie, gdy wynik będzie gotowy, a zapłacisz tylko raz.

Co obejmuje API

API dostarcza wizyty zarejestrowane przez sieci dealerskie producentów dla 38 marek, dla aut od rocznika modelowego 2012. Szczegółowość wpisu zależy od producenta.

Wpisy pochodzą z systemów producentów, więc pokazują serwisy wykonane w autoryzowanych stacjach obsługi. Prace wykonane poza siecią ASO, na przykład w warsztatach niezależnych, nie są rejestrowane w tych systemach. Zakres danych dla każdej marki znajdziesz na stronie marek.

Najczęstsze pytania o API historii serwisowej

Kto może korzystać z API historii serwisowej?

Dostęp do API mają zatwierdzone konta firmowe ServiceStamp. Napisz nam, co budujesz, a go włączymy. Potem doładowujesz saldo oraz tworzysz klucze produkcyjne i testowe i zarządzasz nimi w panelu konta firmowego. Abonament miesięczny jest opcjonalny: obniża cenę zapytania.

Czy potrzebuję numeru VIN?

Tak. Wyślij 17-znakowy numer VIN. API nie wyszukuje auta po numerze rejestracyjnym: sam numer rejestracyjny nie wystarczy do zapytania.

Jak szybko przychodzą wyniki?

Zapytanie zwykle kończy się jednym wywołaniem. Jeśli system producenta potrzebuje więcej czasu, dostaniesz odpowiedź 202 z nagłówkiem Retry-After. Zapytaj ponownie po tym czasie: Twoje wywołanie znów odpytuje producenta i może potrwać kilka sekund, a zapłacisz tylko raz.

Ile kosztuje API?

Zapytanie, które zwraca wpisy, kosztuje 16,99 zł i jest opłacane z salda, które doładowujesz w panelu konta firmowego (jednorazowo od 200,00 zł do 40 000,00 zł). Opcjonalny abonament miesięczny kosztuje 259,99 zł miesięcznie za konto firmowe i obniża cenę każdego zapytania do 12,99 zł, więc opłaca się od 65 zapytań miesięcznie. Zapytanie, które nie znajdzie żadnych wpisów serwisowych producenta, nic nie kosztuje, a ponowne zapytanie o to samo auto w ciągu 24 godzin jest bezpłatne. Abonament możesz anulować w każdej chwili; pozostaje aktywny do końca opłaconego miesiąca.

Co się stanie, gdy skończy się saldo?

Zapytania produkcyjne zwracają kod 402, dopóki nie doładujesz salda. Napiszemy do Ciebie e-mailem, gdy saldo spadnie poniżej 200,00 zł, i ponownie, gdy zapytanie zostanie odrzucone. Klucze testowe działają dalej.

Co, jeśli zapytam dwa razy o to samo auto?

Ponowne zapytanie o to samo auto z Twojego konta w ciągu 24 godzin zwraca raport, który już masz, i jest bezpłatne. Dlatego też ponowna próba po odpowiedzi 202 nigdy nie jest płatna dwa razy.

Czy jest środowisko testowe (sandbox)?

Tak. Poproś o klucz testowy (zaczyna się od ss_test_). Zwraca przykładowy raport dla każdego poprawnego numeru VIN, nigdy nie obciąża salda i nigdy nie łączy się z systemami producentów. VIN TEST0000000000204 zwraca odpowiedź „brak wpisów”, a TEST0000000000202 odpowiedź „w trakcie przetwarzania”, więc przygotujesz się na każdy przypadek przed przejściem na produkcję.

Czy jest limit żądań?

Tak, domyślnie 60 żądań na minutę na konto, wspólnie dla wszystkich Twoich kluczy. Każda odpowiedź zawiera nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. Jeśli potrzebujesz więcej, daj nam znać.

Czy API sprawdza zastawy, szkody albo kradzieże?

Nie. API obejmuje sprawdzenie historii serwisowej: wizyty w ASO zarejestrowane przez producenta dla danego numeru VIN. Nie zawiera informacji o zastawach i finansowaniu, danych o szkodach i kolizjach ani danych o kradzieżach.

Czy zapytania API widać w panelu konta firmowego?

Tak. Każde zapytanie pojawia się w panelu konta firmowego obok sprawdzeń zlecanych w panelu, więc widzi je cały Twój zespół.

Czy mogę udostępniać wyniki kupującym?

Tak. Każda odpowiedź zawiera report_url z linkiem do pełnego raportu ServiceStamp, który możesz udostępnić kupującemu albo pobrać jako PDF.

Chcesz połączyć swoje systemy?

Napisz nam, co budujesz i ile mniej więcej aut sprawdzasz w miesiącu, a wszystko dla Ciebie przygotujemy.

Albo e-mailem: hello@servicestamp.pl

Kupujesz lub sprzedajesz wiele aut?

Raporty już od 21,99 zł w stałej cenie dla firm – do tego opiekun konta i wspólny panel dla zespołu.

Zapytaj o konto firmowe