การวิเคราะห์

รับสถิติการใช้งานรวมสำหรับบัญชีของคุณ — การอัปโหลดตามเวลา, การเติบโตของพื้นที่จัดเก็บ, การแยกประเภทไฟล์ และแบนด์วิดท์ gateway สามารถกรองตามช่วงเวลาและ API key

รับข้อมูลการวิเคราะห์

GET /analytics

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
from	number	ใช่	เวลาเริ่มต้นเป็น unix milliseconds
to	number	ใช่	เวลาสิ้นสุดเป็น unix milliseconds
apiKey	string	ไม่	กรองตาม API key prefix (เช่น "bws_0a3ff5f7") หรือ signed token prefix (เช่น "sup_a1b2c3d4") แสดงเฉพาะการอัปโหลดที่ทำด้วยคีย์หรือโทเค็นนั้น

ตัวอย่างคำขอ

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

การตอบกลับ 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 สะท้อนการใช้งานของเดือนปัจจุบันโดยไม่คำนึงถึงช่วง from/to ตัวกรอง apiKey ใช้ได้เฉพาะกับตัวชี้วัดการอัปโหลด — แบนด์วิดท์ gateway เป็นของทั้งบัญชี Signed upload token prefix ถูกจัดเก็บในฟิลด์เดียวกับ API key prefix ดังนั้นคุณสามารถกรองตาม signed token prefix (เช่น sup_a1b2c3d4) เพื่อดูการอัปโหลดที่ทำด้วย signed token เฉพาะ