Analitik

Dapatkan statistik penggunaan terkumpul untuk akaun anda — muat naik dari masa ke masa, pertumbuhan storan, pecahan jenis fail dan lebar jalur gateway. Boleh ditapis mengikut julat masa dan API key.

Dapatkan Analitik

GET /analytics

Parameter	Jenis	Diperlukan	Penerangan
from	number	Ya	Cap masa mula dalam unix milliseconds.
to	number	Ya	Cap masa tamat dalam unix milliseconds.
apiKey	string	Tidak	Tapis mengikut API key prefix (cth. "bws_0a3ff5f7") atau signed token prefix (cth. "sup_a1b2c3d4"). Hanya menunjukkan muat naik yang dibuat dengan kunci atau token tersebut.

Contoh permintaan

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

Respons 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 mencerminkan penggunaan bulan semasa tanpa mengira julat from/to. Penapis apiKey hanya terpakai pada metrik muat naik — lebar jalur gateway adalah seluruh akaun. Prefix signed upload token disimpan dalam medan yang sama dengan prefix API key, jadi anda boleh menapis mengikut prefix signed token (cth. sup_a1b2c3d4) untuk melihat muat naik yang dibuat dengan signed token tertentu.