Analytics

Dapatkan statistik penggunaan agregat untuk akun Anda — unggahan dari waktu ke waktu, pertumbuhan penyimpanan, rincian jenis file, dan bandwidth gateway. Dapat difilter berdasarkan rentang waktu dan API key.

Dapatkan Analytics

GET /analytics

Parameter	Tipe	Wajib	Deskripsi
from	number	Ya	Timestamp awal dalam milidetik Unix.
to	number	Ya	Timestamp akhir dalam milidetik Unix.
apiKey	string	Tidak	Filter berdasarkan prefiks API key (misalnya "bws_0a3ff5f7") atau prefiks token bertanda tangan (misalnya "sup_a1b2c3d4"). Hanya menampilkan unggahan yang dibuat dengan key 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 berjalan terlepas dari rentang from/to. Filter apiKey hanya berlaku untuk metrik unggahan — bandwidth gateway bersifat seluruh akun. Prefiks token unggah bertanda tangan disimpan di bidang yang sama dengan prefiks API key, jadi Anda dapat memfilter berdasarkan prefiks token bertanda tangan (misalnya sup_a1b2c3d4) untuk melihat unggahan yang dibuat dengan token bertanda tangan tertentu.