Report

Statistiche e contatori della tua officina.

2 endpoint Versione v1 · revisione 2026-07-20

Gli endpoint sono relativi a https://api.officina.it e richiedono l'header Authorization: Bearer con la chiave API e X-API-Version: 2026-07-20. L'header della revisione è obbligatorio: differenza fra v1 e revisione.

GET /v1/dealership-report/{widget}
Permesso richiesto reports.read

Recupera un widget concessionaria

Come GET /v1/report/{widget}, ma per le statistiche della concessionaria. Stessa busta di risposta.
Risposte
200
I dati del widget concessionaria.
401
Chiave API mancante, non valida, revocata o scaduta.
402
Il piano non include l'accesso API, oppure non è attivo un abbonamento.
403
La chiave non ha il permesso richiesto per questa operazione.
404
La risorsa non esiste, è stata eliminata o non appartiene alla tua officina.
500
Errore imprevisto del server. Il dettaglio finisce nei log, non nella risposta.
Richiesta
curl https://api.officina.it/v1/dealership-report/{widget} \
  -H "Authorization: Bearer ofk_live_LA_TUA_CHIAVE" \
  -H "X-API-Version: 2026-07-20"
Risposta
{
  "object": "report_widget",
  "widget": "stock_aging",
  "preset": "year",
  "from": "2026-01-01",
  "to": "2026-12-31",
  "data": [
    {
      "label": "0-30 giorni",
      "value": 4
    },
    {
      "label": "31-90 giorni",
      "value": 7
    }
  ]
}
GET /v1/report/{widget}
Permesso richiesto reports.read

Recupera un widget di report

Restituisce i dati di un singolo widget delle statistiche officina. Il nome del widget va nel percorso; l'intervallo si sceglie con preset oppure con from / to. La risposta è una busta uniforme: widget ripete il widget richiesto, preset, from e to riportano l'intervallo effettivamente applicato e data contiene il risultato, la cui forma dipende dal widget.
Risposte
200
I dati del widget richiesto.
401
Chiave API mancante, non valida, revocata o scaduta.
402
Il piano non include l'accesso API, oppure non è attivo un abbonamento.
403
La chiave non ha il permesso richiesto per questa operazione.
404
La risorsa non esiste, è stata eliminata o non appartiene alla tua officina.
422
Un campo della richiesta manca o non è valido: «param» indica quale.
500
Errore imprevisto del server. Il dettaglio finisce nei log, non nella risposta.
Richiesta
curl https://api.officina.it/v1/report/{widget} \
  -H "Authorization: Bearer ofk_live_LA_TUA_CHIAVE" \
  -H "X-API-Version: 2026-07-20"
Risposta
{
  "object": "report_widget",
  "widget": "revenue_by_month",
  "preset": "year",
  "from": "2026-01-01",
  "to": "2026-12-31",
  "data": [
    {
      "label": "2026-06",
      "value": 12480.5
    },
    {
      "label": "2026-07",
      "value": 15230.0
    }
  ]
}