Scopri come integrare InfoTarga

Migrazione API v1 → v2

Se stai già utilizzando InfoTarga con le API v1, la migrazione alla v2 è diretta e non comporta modifiche alla struttura dei dati veicolo. Il contenuto all’interno di data è identico. Le modifiche introdotte dalla v2 riguardano esclusivamente:

• il base URL
• la standardizzazione dei parametri
• la semplificazione della struttura della risposta
• lo spostamento dei segnali operativi negli header HTTP

1
### v1 • L'API è ancora raggiungibile su:
2
https://infotarga.com/api/query
3

4
### v2 • La nuova versione è disponibile su:
5
https://api.infotarga.com/v2/query

Per una panoramica completa sul funzionamento delle richieste consulta Richiesta e Parametri. Se vuoi invece approfondire la struttura della risposta, visita Risposte ed errori.

Richieste

Con il passaggio alla nuova API v2, abbiamo introdotto una maggiore flessibilità nella struttura delle richieste. Ora puoi scegliere se includere la targa direttamente nell'URL o passarla come parametro nel body della richiesta. Entrambe le modalità sono supportate e funzionano in modo equivalente.

Con la versione precedente delle API, avevi a disposizione due modi per interrogare InfoTarga.

1
curl "https://infotarga.com/api/query/:plate" \
2
  -H "x-api-key: {YOUR_API_KEY}" \
3
  -H "Content-Type: application/json" \
4
  -d '{ "vehicleType": "car", "includeDetails": true, "includeInsurance": true }'

1
curl "https://infotarga.com/api/query/:plate?details=true&insurance=true" \
2
  -H "x-api-key: {YOUR_API_KEY}"

Con la nuova API v2, puoi continuare ad utilizzare entrambe le modalità, con parametri unificati e coerenti.

1
curl "https://api.infotarga.com/v2/query/:plate" \
2
  -H "x-api-key: {YOUR_API_KEY}" \
3
  -H "Content-Type: application/json" \
4
  -d '{ "type": "car", "details": true, "insurance": true }'

1
curl "https://api.infotarga.com/v2/query" \
2
  -H "x-api-key: {YOUR_API_KEY}" \
3
  -H "Content-Type: application/json" \
4
  -d '{ "plate": "{plate}", "type": "car", "details": true, "insurance": true }'

1
curl "https://api.infotarga.com/v2/query?plate={plate}&type=car&details=true&insurance=true" \
2
  -H "x-api-key: {YOUR_API_KEY}"

La scelta tra queste opzioni dipende dalle tue preferenze e dalla struttura della tua integrazione.

Standardizzazione dei parametri

Nella versione precedente dell'API i parametri di personalizzazione della richiesta differivano tra GET e POST, in v2 invece i parametri sono unificati e coerenti per entrambi i metodi.

La documentazione completa dei parametri aggiornati è disponibile in Parametri.

Struttura di risposta

Il contenuto di data non cambia. Cambiano invece alcuni campi della struttura generale della risposta, che è stata semplificata e resa più coerente.

In particolare, il campo error è stato sostituito da success, e il campo code ora è in minuscolo. Inoltre, sono stati rimossi dal body i segnali operativi come overQuota ed eventId, che ora vengono esposti tramite header HTTP. Il parsing dei dati all’interno di data rimane invariato.

In v2 le informazioni operative vengono esposte tramite header HTTP invece che nel body JSON. Se la tua integrazione in v1 utilizzava overQuota, eventId o segnali di rate limiting dal body, ora deve leggere tali informazioni dagli header della risposta. Il dettaglio completo è disponibile nella pagina Risposte ed errori.

Una volta aggiornato il base URL e uniformati i parametri, la tua integrazione continuerà a funzionare con la stessa struttura dati, su una superficie API più coerente e pulita.