Analítiques

Obteniu estadístiques d'ús agregades per al vostre compte — pujades al llarg del temps, creixement d'emmagatzematge, desglossament de tipus de fitxer i amplada de banda del gateway. Filtrable per rang de temps i API key.

Obtenir Analítiques

GET /analytics

Paràmetre	Tipus	Requerit	Descripció
from	number	Sí	Marca de temps d'inici en unix milliseconds.
to	number	Sí	Marca de temps de fi en unix milliseconds.
apiKey	string	No	Filtrar per API key prefix (p. ex. "bws_0a3ff5f7") o signed token prefix (p. ex. "sup_a1b2c3d4"). Només mostra pujades fetes amb aquella clau o token.

Exemple de sol·licitud

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

Resposta 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 reflecteix l'ús del mes actual independentment del rang from/to. El filtre apiKey només s'aplica a mètriques de pujada — l'amplada de banda del gateway és de tot el compte. Els prefix de signed upload token s'emmagatzemen al mateix camp que els prefix d'API key, de manera que podeu filtrar per prefix de signed token (p. ex. sup_a1b2c3d4) per veure pujades fetes amb un signed token específic.