分析

获取账户的汇总使用统计信息 — 上传趋势、存储增长、文件类型分布和网关带宽。可按时间范围和 API 密钥筛选。

获取分析数据

GET /analytics

参数	类型	必填	描述
from	number	是	起始时间戳，Unix 毫秒。
to	number	是	结束时间戳，Unix 毫秒。
apiKey	string	否	按 API 密钥前缀（如 "bws_0a3ff5f7"）或签名令牌前缀（如 "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 筛选仅适用于上传指标 — 网关带宽是账户范围的。签名上传令牌前缀与 API 密钥前缀存储在同一字段中，因此您可以按签名令牌前缀（如 sup_a1b2c3d4）筛选，查看使用特定签名令牌进行的上传。