Analytics

Ottieni statistiche di utilizzo aggregate per il tuo account — caricamenti nel tempo, crescita dello spazio di archiviazione, suddivisione per tipo di file e larghezza di banda del gateway. Filtrabile per intervallo di tempo e API key.

Ottieni Analytics

GET /analytics

Parametro	Tipo	Obbligatorio	Descrizione
from	number	Si'	Timestamp di inizio in millisecondi Unix.
to	number	Si'	Timestamp di fine in millisecondi Unix.
apiKey	string	No	Filtra per prefisso API key (es. "bws_0a3ff5f7") o prefisso token firmato (es. "sup_a1b2c3d4"). Mostra solo i caricamenti effettuati con quella chiave o token.

Esempio di richiesta

curl "https://api.ipfs.ninja/analytics?from=1711036800000&to=1711641600000" \
  -H "X-Api-Key: bws_your_api_key_here"

Risposta 200 OK

{
  "period": { "from": 1711036800000, "to": 1711641600000 },
  "totals": {
    "uploads": 42,
    "storageMB": 15.3,
    "fileTypes": { "json": 25, "image": 12, "pdf": 5 }
  },
  "daily": [
    { "date": "2026-03-21", "uploads": 20, "sizeMB": 8.1 },
    { "date": "2026-03-22", "uploads": 22, "sizeMB": 7.2 }
  ],
  "storageGrowth": [
    { "date": "2026-03-21", "cumulativeMB": 8.1 },
    { "date": "2026-03-22", "cumulativeMB": 15.3 }
  ],
  "gatewayBandwidthMB": 1200,
  "gatewayBandwidthLimitMB": 51200
}

TIP

gatewayBandwidthMB riflette l'utilizzo del mese corrente indipendentemente dall'intervallo from/to. Il filtro apiKey si applica solo alle metriche di caricamento — la larghezza di banda del gateway e' a livello di account. I prefissi dei token di caricamento firmati sono memorizzati nello stesso campo dei prefissi delle API key, quindi puoi filtrare per prefisso del token firmato (es. sup_a1b2c3d4) per vedere i caricamenti effettuati con un token firmato specifico.