API Revisioni Veicoli

Storico revisioni dal Portale dell'Automobilista

Autenticazione

Tutte le chiamate a /api/revisioni richiedono un token API valido con crediti disponibili. Ogni chiamata scala 1 credito.

Il token si passa in uno di questi modi:

# Header Authorization
curl -H "Authorization: Bearer TOKEN" https://host/api/revisioni/AB123CD

# Query string
curl https://host/api/revisioni/AB123CD?token=TOKEN

Endpoints

GET /api/revisioni/:plate

Restituisce lo storico revisioni per la targa indicata. Usa la cache se disponibile.

ParametroTipoDescrizione
plate string path Targa del veicolo (5-8 caratteri alfanumerici)
token string query Token API (alternativa all'header Authorization)
GET /api/revisioni/AB123CD

{
  "success": true,
  "source": "portal",
  "data": {
    "plate": "AB123CD",
    "informations": [
      {
        "type": "revisione",
        "datRvs": "2024-01-15",
        "flgEsiRvsVei": "P",
        ...
      }
    ]
  }
}
GET /api/revisioni/:plate/refresh

Come sopra, ma forza il refresh dalla fonte ignorando la cache.

GET /api/health

Health check del server. Non richiede autenticazione.

GET /api/health

{ "status": "ok", "timestamp": "2025-01-01T12:00:00.000Z" }

Codici di risposta

CodiceDescrizione
200Successo
400Formato targa non valido
401Token API mancante o non valido
403Crediti esauriti
429Rate limit superato (30 req/min)
502Errore dal portale dell'automobilista

Limiti

LimiteValore
Rate limit30 richieste / minuto
Costo per chiamata1 credito
Cache TTL8760 ore (1 anno) default