Admin 配額管理 API
v0.4.0+ 管理員額度操作端點（僅 Admin / Manager）
端點總覽
| 方法 | 路徑 | 說明 |
|---|---|---|
| POST | /api/v1/admin/users/{id}/quota/add | 為用戶增加功能配額 |
| POST | /api/v1/admin/devices/{id}/quota/add | 為設備增加功能配額 |
權限與安全
- 角色：
Admin/Manager - 建議所有操作都附
notes，便於審計追蹤。 - 後端採原子 SQL 更新，支援併發安全。
1) 為用戶增加配額
POST /api/v1/admin/users/{id}/quota/add
請求欄位
| 參數 | 型別 | 說明 |
|---|---|---|
analysisSeconds | Number | 增加分析秒數 (≥1) |
alertCount | Number | 增加告警次數 (≥1) |
attributeCount | Number | 增加屬性偵測次數 (≥1) |
vlmTokens | Number | 增加 VLM token (≥1) |
notes | String | 備註（≤500 字） |
至少要提供四個數值欄位中的一個。
2) 為設備增加配額
POST /api/v1/admin/devices/{id}/quota/add
請求欄位
| 參數 | 型別 | 說明 |
|---|---|---|
featureType | Enum | analysis / alert / attribute / vlm |
amount | Number | 增加量 (≥1) |
notes | String | 備註（≤500 字） |
錯誤回應
| HTTP 狀態 | 說明 |
|---|---|
| 404 | 用戶或設備不存在 |
| 403 | 非管理角色 |
實務建議
- 以月為單位批次加值，並保留工單號在
notes。 - 前端操作完成後，立即刷新 Billing Dashboard 與 Usage API。