Storico revisioni dal Portale dell'Automobilista
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
Restituisce lo storico revisioni per la targa indicata. Usa la cache se disponibile.
| Parametro | Tipo | Descrizione | |
|---|---|---|---|
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",
...
}
]
}
}
Come sopra, ma forza il refresh dalla fonte ignorando la cache.
Health check del server. Non richiede autenticazione.
GET /api/health
{ "status": "ok", "timestamp": "2025-01-01T12:00:00.000Z" }
| Codice | Descrizione |
|---|---|
| 200 | Successo |
| 400 | Formato targa non valido |
| 401 | Token API mancante o non valido |
| 403 | Crediti esauriti |
| 429 | Rate limit superato (30 req/min) |
| 502 | Errore dal portale dell'automobilista |
| Limite | Valore |
|---|---|
| Rate limit | 30 richieste / minuto |
| Costo per chiamata | 1 credito |
| Cache TTL | 8760 ore (1 anno) default |