Primi passi con l’API di Prisradar
L’API di Prisradar restituisce per un’auto il valore di mercato in franchi, con forbice, affidabilità e numero di annunci comparabili. Funziona con qualsiasi linguaggio di programmazione in grado di inviare una richiesta HTTPS.
curl -X POST https://prisradar.ch/api/v1/valuations \
-H "Authorization: Bearer $PRISRADAR_KEY" \
-H "Content-Type: application/json" \
-d '{
"make": "Audi",
"model": "Q5",
"year": 2021,
"mileageKm": 50000,
"fuel": "diesel",
"transmission": "automatic"
}'{
"id": "val_kglReIcl8Sw0",
"test": false,
"vehicle": {
"make": "Audi",
"model": "Q5",
"year": 2021,
"mileageKm": 50000,
"fuel": "diesel",
"transmission": "automatic"
},
"value": {
"chf": 34600,
"low": 28400,
"high": 42100,
"basis": "asking_prices"
},
"confidence": {
"level": "hoch",
"score": 0.84
},
"comparables": {
"count": 10,
"closeness": "eng",
"level": "configuration"
},
"notes": [],
"attribution": {
"text": "Preisorientierung von prisradar.ch",
"url": "https://prisradar.ch"
},
"dataAsOf": "2026-10-13T00:21:50.494Z"
}Come arrivo alla prima valutazione?
In quattro passi: creare un account, ottenere una chiave di test nella console, inviare la prima richiesta a /v1/valuations e leggere la risposta. Con la chiave di test non costa nulla. Appena il Suo software funziona, sceglie e paga un pacchetto nella console e crea una chiave live con valori reali.
POSThttps://prisradar.ch/api/v1/valuations
- 1Creare l’accountAlla pagina Crea un account con ditta, nome, e-mail e password. Conferma l’e-mail con un clic; l’accesso con codice può attivarlo in seguito.
- 2Ottenere una chiave di testNella console, in «Chiavi». Le chiavi di test iniziano con pr_test_ e restituiscono valori d’esempio fissi.
- 3Inviare la richiestaInviare la chiave nell’header Authorization: Bearer … e l’auto come JSON.
- 4Leggere la rispostavalue.chf è il valore di mercato, low e high la forbice, confidence.level l’affidabilità.
Quali dati servono per una valutazione?
Sono obbligatori sei dati: marca, modello, anno della prima immatricolazione, chilometraggio, carburante e cambio. Potenza, trazione, carrozzeria, venditore e stato sono facoltativi e rendono il valore più preciso. Marca e modello può scriverli come li conosce il Suo software; l’API trova la grafia nel catalogo.
Tutti i campi sono descritti in Valutazione. La descrizione leggibile da macchina dell’intera API è disponibile come file OpenAPI; maggiori informazioni sul formato su openapis.org.
In che formato risponde l’API?
L’API risponde in JSON con codifica UTF-8. Gli importi sono in franchi interi IVA inclusa, arrotondati a 100, per esempio 34600. I chilometri sono numeri interi, gli orari seguono ISO 8601 in UTC. I nomi dei campi sono in inglese, messaggi e avvertenze in tedesco, così può mostrarli direttamente.
Solo dal server.Interroghi l’API dal Suo server, mai direttamente da un’app o da un sito web. Altrimenti la Sua chiave è visibile a tutti. La salvi in una variabile d’ambiente, mai fissa nel codice.
Cosa non può fare l’API?
L’API non valuta tramite numero di telaio o certificato del tipo, perché per questo servono dati con licenza. Non conosce la dotazione nel dettaglio; il valore vale per un’auto con dotazione media. Non fornisce annunci, foto né dati dei venditori, e le auto con più di 25 anni non ricevono un valore.
Prezzi d’offerta, non prezzi di vendita.Il valore si basa su annunci svizzeri attuali. A quanto un’auto sia stata venduta alla fine, non lo sa nessuno.
Non ha trovato ciò che cerca?Scriva a info@prisradar.ch o tramite il modulo di contatto.