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.
curl -G "https://api.servicestamp.pl/v1/service-history" \
-d vin=WVWZZZAUZKP508214 \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"result": {
"vehicle_identification_number": "WVWZZZAUZKP508214",
"service_events": [
{
"date_of_service_event": "2024-09-12",
"service_provider": "Autoryzowany serwis Volkswagen, Poznań",
"mileage_observed": 45230,
"mileage_unit": "km"
}
]
}
}Pokaż historię serwisową producenta tam, gdzie Twój zespół i Twoi kupujący już zaglądają, bez ręcznego zlecania sprawdzeń.
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.
Pokazuj sprawdzoną historię serwisową na stronach swoich aut: liczbę wizyt w ASO, datę ostatniego serwisu i przebieg.
Dodaj historię serwisową producenta do strony każdego auta na aukcji, żeby kupujący widzieli ją przed rozpoczęciem licytacji.
Po zakończeniu umów sprawdzaj historię serwisową wszystkich zwracanych aut za jednym razem, bez wpisywania każdego auta osobno.
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.
Jedno uwierzytelnione żądanie na auto, z Twoim kluczem w nagłówku x-api-key.
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.
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" }
]
}
]
}
}| Pole | Znaczenie |
|---|---|
| date_of_service_event | Kiedy wykonano serwis |
| service_provider | Dealer, który wykonał prace |
| mileage_observed / mileage_unit | Przebieg podczas wizyty w serwisie, w km albo mi |
| service_type | Rodzaj wizyty w serwisie |
| service_items | Każda wykonana czynność, z jej kategorią |
| report_url | Peł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.
Płacisz tylko wtedy, gdy wracają wpisy.
| Kod | Znaczenie |
|---|---|
| 200 | Znaleziono wpisy. Z Twojego salda API pobieramy 16,99 zł, a w abonamencie miesięcznym 12,99 zł. |
| 202 | System producenta wciąż pracuje. Spróbuj ponownie po czasie podanym w nagłówku Retry-After. Płacisz tylko wtedy, gdy wracają wpisy. |
| 204 | Producent nie ma żadnych wpisów serwisowych dla tego auta. Nic nie pobieramy. |
| 400 | Nieprawidłowy numer VIN. |
| 401 | Brak klucza API, klucz jest nieprawidłowy albo został unieważniony. |
| 402 | Saldo API się wyczerpało. Doładuj je w panelu konta firmowego. |
| 403 | Dostęp do API jest wyłączony albo konto firmowe nie jest aktywne. |
| 404 | Nie znaleziono auta o tym numerze VIN. Nic nie pobieramy. |
| 429 | Za dużo żądań. Zwolnij i spróbuj ponownie po czasie podanym w nagłówku Retry-After. |
| 503 | Nie udało nam się zrealizować zapytania. Spróbuj ponownie później. Nic nie pobieramy. |
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ł.
| Pozycja | Cena |
|---|---|
| Zapytanie z wpisami, bez abonamentu | 16,99 zł |
| Abonament miesięczny API (opcjonalny) | 259,99 zł miesięcznie |
| Zapytanie z wpisami, w abonamencie miesięcznym | 12,99 zł |
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.
Odpowiedź „w trakcie przetwarzania” nigdy nie jest płatna. Zapytaj ponownie, gdy wynik będzie gotowy, a zapłacisz tylko raz.
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.
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.
Tak. Wyślij 17-znakowy numer VIN. API nie wyszukuje auta po numerze rejestracyjnym: sam numer rejestracyjny nie wystarczy do zapytania.
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.
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.
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.
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.
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ę.
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ć.
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.
Tak. Każde zapytanie pojawia się w panelu konta firmowego obok sprawdzeń zlecanych w panelu, więc widzi je cały Twój zespół.
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.
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
Raporty już od 21,99 zł w stałej cenie dla firm – do tego opiekun konta i wspólny panel dla zespołu.