REST API

Richieste DGT per portafogli di migliaia di veicoli.

Integra le richieste del tuo stock o della tua flotta tramite lotti di targhe. Segui ogni richiesta, recupera il riepilogo JSON dopo l’analisi e scarica il PDF ufficiale quando disponibile.

Richiedi l’accesso all’API

Un contratto pensato per l’integrazione

Accesso aziendale

Token Bearer con permessi definiti e revoca dal portale aziendale.

Riepilogo JSON e PDF

Il dettaglio del rapporto espone 17 campi del veicolo dopo l’analisi e l’accesso al PDF disponibile. I risultati possono essere nulli durante l’elaborazione.

Lotti asincroni

POST /reports/batch accetta un array plates e restituisce 202. Ogni lotto rispetta il limite configurato e viene elaborato in background.

Idempotenza e monitoraggio

Idempotency-Key identifica le tue richieste. Consulta in seguito stato, avanzamento ed esito tramite GET.

/v1

Endpoint principali

API REST con versione in /api/v1, autenticazione tramite token, limiti e modello di errori documentato.

Autenticazione

Token Bearer associato a un’azienda, con permessi che limitano le operazioni disponibili. Puoi revocare una credenziale dal portale senza influire sulle altre.

Authorization: Bearer <token>

reports	Richiedi un rapporto DGT, elencali, leggine uno, scarica il suo PDF.
reports/batch	Invia molte targhe in una volta sola; il carico viene eseguito fuori dalla richiesta.
usage	Saldo, piano e registro dei movimenti.
vehicles	La tua flotta: facoltativo, perché richiedere un rapporto registra il suo veicolo.
locations · departments · subsidiaries · batches	Come è organizzata la flotta.

Esempio di richiesta di rapporto

curl -X POST https://veriflota.es/api/v1/reports \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"plate":"1234BCD"}'

Risposta iniziale: in attesa di elaborazione

{
  "id": "01M0ANQ0DFADGVM5PV26ZYV3YX",
  "plate": "1234BCD",
  "status": "placed",
  "progress": "queued",
  "requester": { "type": "api_credential", "name": null },
  "placedAt": "2026-08-19T09:14:22+00:00",
  "settledAt": null,
  "outcome": { "returnCode": null, "documentAvailable": false },
  "vehicle": null
}

Modello di errori

Errori JSON coerenti, con codici macchina stabili mappati dalle eccezioni interne.

{
  "error": {
    "code": "insufficient_report_balance",
    "message": "Not enough reports left on this account.",
    "details": { "needed": 5, "available": 2, "shortfall": 3 }
  }
}

unauthenticatedinsufficient_scopevalidation_failedinsufficient_report_balancereport_already_in_flightidempotency_key_reusedrate_limited

Riferimento completo dell’API

Ogni endpoint, corpo di richiesta, campo di risposta e codice di errore, generati dall’API stessa. Accedi per leggerlo; se non hai ancora un account, richiedi prima l’accesso.

Apri il riferimento

Pronto a integrare?

Raccontaci il tuo volume di richieste e le esigenze di integrazione. Ti aiutiamo a preparare l’accesso per la tua impresa.

Richiedi l’accesso all’API