Analize

Obțineți statistici agregate de utilizare pentru contul dvs. -- încărcări în timp, creșterea stocării, distribuția tipurilor de fișiere și lățimea de bandă gateway. Filtrabile după interval de timp și cheie API.

Obținere analize

GET /analytics

Parametru	Tip	Obligatoriu	Descriere
from	number	Da	Timestamp de început în milisecunde unix.
to	number	Da	Timestamp de sfârșit în milisecunde unix.
apiKey	string	Nu	Filtrare după prefixul cheii API (de ex. "bws_0a3ff5f7") sau prefixul tokenului semnat (de ex. "sup_a1b2c3d4"). Afișează doar încărcările efectuate cu acea cheie sau acel token.

Exemplu de cerere

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

Răspuns 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 reflectă utilizarea lunii curente indiferent de intervalul from/to. Filtrul apiKey se aplică doar metricilor de încărcare -- lățimea de bandă gateway este la nivel de cont. Prefixele tokenurilor semnate de încărcare sunt stocate în același câmp ca prefixele cheilor API, astfel încât puteți filtra după prefixul tokenului semnat (de ex. sup_a1b2c3d4) pentru a vedea încărcările efectuate cu un token semnat specific.