Documentazione API

Base URL: http://10.0.40.144:8090/api/v1

Autenticazione

Ogni richiesta richiede l'header:

X-API-Key: vo_...

La key si genera dalla dashboard. Codici di errore: 401 key mancante/non valida, 402 crediti esauriti, 429 rate limit superato.

POST /api/v1/valuation

Stima il prezzo di mercato di un veicolo usato. Ogni chiamata consuma 1 credito.

curl -X POST -H "X-API-Key: vo_..." -H "Content-Type: application/json" \ -d '{"marca":"Volkswagen","modello":"Golf","km":80000,"anno":2020, "alimentazione":"Diesel","regione":"Lombardia"}' \ http://10.0.40.144:8090/api/v1/valuation

Campi: marca*, modello*, km* (0–1.000.000), anno* (1950–oggi); opzionali: alimentazione, cambio, potenza_cv, regione, tipo_venditore, sconto_pct (0/-5/-10/-20), allestimento.

La risposta include stima puntuale, range di prezzo, livello di confidenza e le feature SHAP che hanno influenzato la stima.

GET /api/v1/health

curl -H "X-API-Key: vo_..." http://10.0.40.144:8090/api/v1/health

GET /api/v1/usage

Statistiche d'uso della propria key: chiamate e latenza media per endpoint (ultimi 30 giorni) e crediti residui.

curl -H "X-API-Key: vo_..." http://10.0.40.144:8090/api/v1/usage

Rate limiting

Sliding window per key, in base al piano: Free 10, Starter 30, Pro 60, Business 120 req/min.