使用量統計

使用量統計

取得你的帳號或特定 API key 的使用量指標。

端點

GET /v1/usage

參數

參數	型別	說明
period	string	today、week、month 或 ISO 日期範圍
key_id	string	依特定 API key 篩選（選填）
group_by	string	day、hour、target（選填）

回應

{
  "period": "2026-05-01/2026-05-30",
  "total_requests": 1250000,
  "total_bytes": 53687091200,
  "total_bytes_human": "50 GB",
  "unique_targets": 342,
  "heal_events": 1893,
  "avg_latency_ms": 187,
  "daily": [
    { "date": "2026-05-30", "requests": 45000, "bytes": 1932735283 }
  ]
}