Come interrogare l'API
Puoi interrogare la nostra API v3 con richieste POST. La targa, la tipologia del veicolo e i servizi richiesti devono essere indicati nel corpo della richiesta.
Assicurati di includere sempre la chiave API nell’header x-api-key. Vedi la sezione Autenticazione per maggiori dettagli.
Prepara la tua chiamata POST:
curl "https://api.infotarga.com/v3/query" \ -H "x-api-key: {YOUR_API_KEY}" \ -H "Content-Type: application/json" \ -d '{ "plate": "{plate}", "type": "car", "services": ["details", "insurance"] }'Descrizione dei parametri
| Parametro | Descrizione | Default |
|---|---|---|
plate | La targa da interrogare | (obbligatorio) |
type | La tipologia del veicolo associato alla targa | car |
services | Elenco non vuoto dei servizi da richiedere. Non può contenere valori duplicati | (obbligatorio) |
Tipologia veicolo
Specifica la tipologia del veicolo associato alla targa. Questo parametro è importante per ottenere informazioni accurate, in quanto alcune funzionalità dipendono dal tipo di veicolo (es. revisione per camion e rimorchi).
I valori accettati sono:
carper autoveicoli, rimorchi leggeri e autocarri con massa fino a 3,5tmotorcycleper motocicli con cilindrata superiore a 50ccmopedper ciclomotori con cilindrata fino a 50cctrailerper rimorchi pesantitruckper autocarri con massa superiore a 3,5t
Se type viene omesso oppure contiene un valore non riconosciuto, la richiesta viene trattata come relativa a un'automobile (car).
Servizi richiesti
Il campo services determina quali informazioni devono essere cercate. Deve contenere almeno un servizio e non può includere valori duplicati.
I servizi disponibili e il significato di ciascun valore sono descritti nella pagina Servizi.
L'API v3 non supporta richieste GET né URL con la targa incorporata nel percorso. Consulta Migrazione API v2 → API v3 per le differenze rispetto alla versione precedente.