Analitika

Gaukite suvestinę naudojimo statistiką savo paskyrai — įkėlimai laikui bėgant, saugyklos augimas, failų tipų pasiskirstymas ir gateway pralaidumas. Filtruojama pagal laiko intervalą ir API raktą.

Gauti analitiką

GET /analytics

Parametras	Tipas	Privalomas	Aprašymas
from	number	Taip	Pradžios laiko žyma unix milisekundėmis.
to	number	Taip	Pabaigos laiko žyma unix milisekundėmis.
apiKey	string	Ne	Filtruoti pagal API rakto prefiksą (pvz., "bws_0a3ff5f7") arba pasirašyto tokeno prefiksą (pvz., "sup_a1b2c3d4"). Rodo tik tuo raktu ar tokenu atliktus įkėlimus.

Užklausos pavyzdys

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

Atsakymas 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 atspindi einamojo mėnesio naudojimą nepriklausomai nuo from/to intervalo. apiKey filtras taikomas tik įkėlimo metrikai — gateway pralaidumas yra paskyros lygiu. Pasirašytų įkėlimo tokenų prefiksai saugomi tame pačiame lauke kaip API raktų prefiksai, todėl galite filtruoti pagal pasirašyto tokeno prefiksą (pvz., sup_a1b2c3d4), kad matytumėte konkrečiu pasirašytu tokenu atliktus įkėlimus.