Analytics

Kumuha ng pinagsama-samang usage statistics para sa iyong account — mga upload sa paglipas ng panahon, paglago ng storage, breakdown ng file type, at gateway bandwidth. Maaaring i-filter ayon sa time range at API key.

Kunin ang Analytics

GET /analytics

Parameter	Uri	Kinakailangan	Paglalarawan
from	number	Oo	Start timestamp sa unix milliseconds.
to	number	Oo	End timestamp sa unix milliseconds.
apiKey	string	Hindi	I-filter ayon sa API key prefix (hal. "bws_0a3ff5f7") o signed token prefix (hal. "sup_a1b2c3d4"). Ipinapakita lang ang mga upload na ginawa gamit ang key o token na iyon.

Halimbawang request

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

Response 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

Ang gatewayBandwidthMB ay sumasalamin sa paggamit ng kasalukuyang buwan anuman ang from/to range. Ang apiKey filter ay nalalapat lamang sa upload metrics — ang gateway bandwidth ay account-wide. Ang mga signed upload token prefix ay nakaimbak sa parehong field ng mga API key prefix, kaya maaari mong i-filter ayon sa signed token prefix (hal. sup_a1b2c3d4) para makita ang mga upload na ginawa gamit ang isang partikular na signed token.