Analitika

Összesített használati statisztikákat kaphat fiókjáról -- feltöltések időben, tárhely-növekedés, fájltípus-megoszlás és gateway sávszélesség. Szűrhető időtartomány és API kulcs szerint.

Analitika lekérése

GET /analytics

Paraméter	Típus	Kötelező	Leírás
from	number	Igen	Kezdő időbélyeg unix ezredmásodpercben.
to	number	Igen	Záró időbélyeg unix ezredmásodpercben.
apiKey	string	Nem	Szűrés API kulcs előtag (pl. "bws_0a3ff5f7") vagy aláírt token előtag (pl. "sup_a1b2c3d4") szerint. Csak az adott kulccsal vagy tokennel végzett feltöltéseket mutatja.

Példa kérés

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

Válasz 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

A gatewayBandwidthMB az aktuális hónap használatát tükrözi, függetlenül a from/to tartománytól. Az apiKey szűrő csak a feltöltési metrikákra vonatkozik -- a gateway sávszélesség fiók-szintű. Az aláírt feltöltési token előtagok ugyanabban a mezőben vannak tárolva, mint az API kulcs előtagok, így az aláírt token előtag (pl. sup_a1b2c3d4) alapján szűrhet, hogy lássa az adott aláírt tokennel végzett feltöltéseket.