Usage API

v0.6.0+ 用量查詢端點，支援 period=YYYY-MM

端點總覽

1) 查詢用戶用量摘要

GET /api/v1/usage/user/summary?period=2026-02

響應重點

• analysis: 秒數用量
• alert: 告警次數用量
• attribute: 屬性偵測用量
• vlm: token 用量

{
  "success": true,
  "data": {
    "userId": "user-uuid",
    "period": "2026-02",
    "analysis": { "used": 3600, "limit": 72000, "balance": 68400, "isExceeded": false },
    "alert": { "used": 350, "limit": 10000, "balance": 9650, "isExceeded": false },
    "attribute": { "used": 120, "limit": 5000, "balance": 4880, "isExceeded": false },
    "vlm": { "used": 85000, "limit": 10000000, "balance": 9915000, "isExceeded": false }
  }
}

2) 查詢設備用量

GET /api/v1/usage/devices/{deviceId}?period=2026-02

響應重點

• 設備層級 quotaSeconds / usedSeconds / remainingSeconds
• 各功能子配額：alertQuota / attributeQuota / vlmQuota
• isDisabled / isUnlimited / usagePercentage

錯誤回應

使用建議

• 儀表板首頁顯示 user summary。
• 設備詳情頁顯示 device usage。
• 若要看趨勢與對比，改用 Billing Dashboard API。