Skip to main content
分頁返回帳戶擁有或獲授權使用的 Application,包括餘額、狀態、服務摘要和關聯憑證。適合批量餘額監控、查找 Application ID 和進入憑證管理。

準備工作

  1. 登入 AceDataCloud 平台。
  2. 在 Account Token 控制台建立帳戶權杖。
  3. 一般使用者使用 user_id=me;也可從 GET /api/v1/platform-tokens/me/ 取得自己的 UUID。

介面概覽

一般使用者應傳入 user_id=me。不傳入時查詢未先依帳戶縮小範圍,分頁遇到無權物件可能返回 403;管理員不傳入時可檢視全表。

查詢參數

paid、disabled、expired、low_balance 和 tag 目前不是伺服器端篩選參數。餘額警示應拉取列表後,根據每個 Application 的 remaining_amount、service.unit 和業務閾值在用戶端判斷。

請求範例

同時檢視自己擁有和別人授權給自己的 Application:

回應說明

回應為 {count, items}。每項包含 Application 模型欄位,並附加:
  • service:id、alias、title、type、unit、icon_url;
  • credentials:目前呼叫者有權看到的憑證摘要;
  • paid、remaining_amount、used_amount、disabled、allow_consume_global;
  • scope 的真實值為 Individual 或 Global;
  • type 的真實值為 Usage 或 Period。
remaining_amount 可能為空;用戶端必須先判空,再進行數字比較。額度單位由 service.unit 決定。

下一步