Esegua le verifiche dello storico tagliandi direttamente dai Suoi sistemi. Invii un VIN e riceva i tagliandi registrati dalla rete dei concessionari ufficiali della casa costruttrice come JSON strutturato. 3,99 € per interrogazione con tagliandi, oppure 2,99 € con il piano mensile da 59,99 € al mese.
curl -G "https://api.servicestamp.it/v1/service-history" \
-d vin=WVWZZZAUZKW582047 \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"result": {
"vehicle_identification_number": "WVWZZZAUZKW582047",
"service_events": [
{
"date_of_service_event": "2024-09-12",
"service_provider": "Concessionario Volkswagen autorizzato",
"mileage_observed": 45230,
"mileage_unit": "km"
}
]
}
}Porti lo storico tagliandi della casa costruttrice dove il Suo team e i Suoi acquirenti già guardano, senza che nessuno esegua le verifiche a mano.
Verifichi ogni permuta già in fase di valutazione: i tagliandi finiscono automaticamente nel Suo DMS o nel Suo gestionale dello stock.
Mostri lo storico tagliandi verificato nelle pagine dei Suoi veicoli: il numero di tagliandi in concessionaria, la data dell'ultimo tagliando e il chilometraggio.
Aggiunga alla pagina di ogni lotto lo storico tagliandi della casa costruttrice, perché gli acquirenti lo vedano prima che inizi la fase di offerta.
A fine contratto verifichi la manutenzione di tutti i veicoli rientrati in un solo passaggio, senza digitare ogni veicolo uno per uno.
L'accesso API fa parte di un account Professionisti approvato. Ci contatti e lo attiviamo. Poi ricarica il saldo e crea le Sue chiavi nella Sua Area personale Professionisti. Il piano mensile è opzionale.
Una richiesta autenticata per veicolo, con la Sua chiave nell'header x-api-key.
Ogni tagliando in concessionaria torna con la sua data, il chilometraggio, il concessionario che l'ha eseguito e i lavori svolti, più un link al report ServiceStamp completo.
Una richiesta per veicolo. Ogni tagliando in concessionaria registrato dalla casa costruttrice torna in service_events.
URL di base: https://api.servicestamp.it/v1. Gli stessi endpoint rispondono anche su https://servicestamp.it/api/v1.
Richiesta
curl -G "https://api.servicestamp.it/v1/service-history" \
-d vin=WVWZZZAUZKW582047 \
-H "x-api-key: YOUR_API_KEY"Risposta
{
"success": true,
"result": {
"report_id": "rpt_8Kq2vX",
"report_url": "https://servicestamp.it/report/rpt_8Kq2vX",
"vehicle_identification_number": "WVWZZZAUZKW582047",
"registration_mark": null,
"vehicle": { "make": "Volkswagen", "model": "Golf", "year": 2019, "fuel_type": "Petrol" },
"service_events": [
{
"date_of_service_event": "2024-09-12",
"service_provider": "Concessionario Volkswagen autorizzato",
"mileage_observed": 45230,
"mileage_unit": "km",
"service_type": "serviceVisit",
"service_items": [
{ "item_type": "Service", "item_description": "Cambio olio motore e filtro" },
{ "item_type": "Inspection", "item_description": "Controllo multi-punto di sicurezza" }
]
}
]
}
}| Campo | Significato |
|---|---|
| date_of_service_event | Quando è stato eseguito il tagliando |
| service_provider | Il concessionario che ha eseguito i lavori |
| mileage_observed / mileage_unit | Chilometraggio al passaggio in officina, in km o mi |
| service_type | Il tipo di passaggio in officina |
| service_items | Ogni lavoro eseguito, con la sua categoria |
| report_url | Il report ServiceStamp completo con l'andamento del chilometraggio, da condividere con gli acquirenti o da scaricare in PDF |
Un valore che non abbiamo torna come null e non manca mai: alcune case costruttrici non inviano l'unità del chilometraggio né la categoria del lavoro.
Si paga solo quando tornano tagliandi.
| Codice | Significato |
|---|---|
| 200 | Tagliandi trovati. 3,99 € vengono scalati dal Suo saldo API, oppure 2,99 € con il piano mensile. |
| 202 | Il sistema della casa costruttrice sta ancora lavorando. Riprovi dopo il tempo indicato nell'header Retry-After. Si paga solo quando tornano tagliandi. |
| 204 | Nessun tagliando della casa costruttrice per questo veicolo. Non viene addebitato. |
| 400 | VIN non valido. |
| 401 | La chiave API manca, non è valida o è stata revocata. |
| 402 | Il Suo saldo API è esaurito. Lo ricarichi nella Sua Area personale Professionisti. |
| 403 | L'accesso API è disattivato o l'account Professionisti non è attivo. |
| 404 | Nessun veicolo trovato per questo VIN. Non viene addebitato. |
| 429 | Troppe richieste. Rallenti e riprovi dopo il tempo indicato nell'header Retry-After. |
| 503 | L'interrogazione non è stata completata da parte nostra. Riprovi più tardi. Non viene addebitata. |
Le interrogazioni vengono scalate da un saldo ricaricato in anticipo, a 3,99 € ciascuna e solo quando tornano tagliandi. Il piano mensile opzionale da 59,99 € al mese riduce questo prezzo a 2,99 €, conviene da 60 interrogazioni al mese ed è annullabile in qualsiasi momento. Ricarichi il Suo saldo a partire da 50,00 € con carta nella Sua Area personale.
| Voce | Prezzo |
|---|---|
| Interrogazione con tagliandi, pagamento per interrogazione | 3,99 € |
| Piano mensile dell'API (opzionale) | 59,99 € al mese |
| Interrogazione con tagliandi, con il piano mensile | 2,99 € |
Un'interrogazione che non trova tagliandi della casa costruttrice non costa nulla, esattamente come le verifiche che esegue come Professionista dalla Sua Area personale.
Una risposta «ancora in elaborazione» non viene mai addebitata. Interroghi di nuovo quando il risultato è pronto e paga una sola volta.
L'API fornisce i tagliandi registrati dalla rete dei concessionari ufficiali delle case costruttrici per 38 marchi, per i veicoli dall'anno modello 2012 in poi. Quanto è dettagliato un tagliando dipende dalla casa costruttrice.
I tagliandi provengono dai sistemi delle case costruttrici e mostrano quindi la manutenzione eseguita presso i concessionari ufficiali. I lavori fuori dalla rete ufficiale non sono registrati in quei sistemi. La copertura di ogni singolo marchio è nella pagina delle case costruttrici.
L'accesso API è aperto agli account Professionisti ServiceStamp approvati. Ci racconti cosa sta sviluppando e lo attiviamo. Poi ricarica il saldo e crea e gestisce le Sue chiavi live e di test nella Sua Area personale Professionisti. Il piano mensile è opzionale: riduce il prezzo per interrogazione.
Sì. Invii il VIN a 17 caratteri. L'API non cerca un veicolo dalla targa, quindi con la sola targa non è possibile alcuna interrogazione.
Le interrogazioni si completano di norma con una sola chiamata. Se il sistema di una casa costruttrice impiega più tempo, riceve una risposta 202 con l'header Retry-After. Interroghi di nuovo dopo quel tempo: la Sua chiamata interroga nuovamente la casa costruttrice, può richiedere alcuni secondi, e si paga una sola volta.
3,99 € per ogni interrogazione con tagliandi, scalati da un saldo che ricarica con carta nella Sua Area personale Professionisti (da 50,00 € a 10.000,00 € per ricarica). Il piano mensile opzionale costa 59,99 € al mese per account Professionisti e riduce ogni interrogazione a 2,99 €: conviene quindi da 60 interrogazioni al mese. Un'interrogazione che non trova tagliandi della casa costruttrice non costa nulla, e interrogare di nuovo lo stesso veicolo entro 24 ore è gratuito. Può annullare il piano mensile in qualsiasi momento; resta attivo fino alla fine del mese già pagato.
Le interrogazioni live rispondono con 402 finché non ricarica il saldo. Le scriviamo via e-mail quando il saldo scende sotto 50,00 €, e di nuovo quando un'interrogazione viene rifiutata. Le chiavi di test continuano a funzionare.
Una seconda interrogazione dello stesso veicolo dal Suo account entro 24 ore restituisce il report che ha già e non viene addebitata. Per questo anche un nuovo tentativo dopo una risposta 202 non viene mai addebitato due volte.
Sì. Chieda una chiave di test (inizia con ss_test_). Restituisce un report di esempio per qualsiasi VIN valido, non scala mai il Suo saldo e non contatta mai i sistemi delle case costruttrici. Il VIN TEST0000000000204 restituisce la risposta «nessun tagliando» e TEST0000000000202 la risposta «ancora in elaborazione», così può preparare ogni caso prima di andare live.
Sì, di default 60 richieste al minuto per account, condivise tra tutte le Sue chiavi. Ogni risposta contiene gli header X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Se Le serve di più, ce lo dica.
No. L'API copre la verifica dello storico tagliandi: i tagliandi della rete dei concessionari ufficiali che la casa costruttrice ha registrato per un VIN. Non contiene precedenti finanziari o ipoteche, sinistri né dati sui furti.
Sì. Ogni interrogazione compare nella Sua Area personale Professionisti accanto alle verifiche che esegue da lì, così tutto il Suo team può vederla.
Sì. Ogni risposta contiene una report_url al report ServiceStamp completo, che può condividere con un acquirente o scaricare in PDF.
Ci racconti cosa sta sviluppando e quanti veicoli verifica all'incirca ogni mese, e prepariamo tutto per Lei.
Oppure via e-mail: hello@servicestamp.it
Report a partire da 4,99 € al prezzo fisso per professionisti, con supporto dedicato e area personale per il tuo team.