API storico revisioni: REST, JSON, API key

L'endpoint

La verifica si esegue con una singola chiamata HTTP GET, autenticandosi con la propria API key nell'header X-API-Key:

GET /api/v1/verifica?targa=EF584LY
Host: revisioni-online.it
X-API-Key: roxxxxxxxxxxxxxxxxxxxx

Risposta

La risposta è in formato JSON e contiene tutte le revisioni registrate per la targa richiesta:

{
  "success": true,
  "targa": "EF584LY",
  "count": 3,
  "risultati": [
    {
      "data_revisione": "15/03/2024",
      "esito_revisione": "POSITIVO",
      "km_rilevati": "87500",
      "targa": "EF584LY"
    }
  ]
}

I campi restituiti per ogni revisione sono tre: data, esito e chilometri rilevati. Lo storico copre le revisioni dal 1° giugno 2018, come previsto dal Portale dell'Automobilista.

Esempio con cURL

curl -s "https://revisioni-online.it/api/v1/verifica?targa=EF584LY"   -H "X-API-Key: roxxxxxxxxxxxxxxxxxxxx"

In caso di errore

Se la targa non è valida o la chiave non è autorizzata, la risposta segue lo stesso formato con success: false:

{
  "success": false,
  "error": "Formato targa non valido: 'ABCDEFG'"
}

Come ottenere una API key

Crea un account gratuito dalla home (basta un'email, nessuna password)
Attiva un piano Pro o Business, che includono l'accesso API
Genera la tua chiave dalla dashboard, sezione «API Keys»

Le chiavi hanno il prefisso ro_ e possono essere rigenerate o revocate in qualsiasi momento. Ogni chiave ha un proprio rate limit per proteggere il servizio.

Casi d'uso tipici

Siti di annunci auto: mostra lo storico revisioni direttamente nella scheda del veicolo, aumentando la fiducia degli acquirenti
Gestionali per concessionarie e officine: arricchisci la scheda cliente con i dati di revisione aggiornati
Software per flotte: allerta automatiche quando la revisione di un veicolo aziendale si avvicina alla scadenza
App per compravendita: verifica istantanea al momento della valutazione dell'usato

Disponibilità e limiti

L'endpoint è sincrono: la risposta arriva quando la verifica è completata, in genere entro pochi secondi. Il rate limit per chiave è pensato per un uso professionale; il piano Business include un accesso prioritario. Per dubbi sull'uso del servizio consulta le domande frequenti; per i volumi e i costi consulta la pagina dei prezzi.

Integra la verifica revisioni nel tuo software