Skip to main content
依日期和 API 彙總目前帳戶的請求次數與實際扣除額度,適合製作月報、趨勢圖和成本分析。需要逐筆除錯時使用呼叫紀錄列表,需要完整離線明細時使用呼叫量匯出。

準備工作

  1. 登入 AceDataCloud 平台。
  2. 在 Account Token 控制台建立帳戶權杖,並立即儲存。
  3. 如需縮小範圍,從服務申請列表、API 憑證列表或API 列表取得相應 ID。
完整權杖說明請見管理帳戶權杖。本介面使用 Account Token,不使用業務 Credential。

介面概覽

查詢參數

start_time / end_time 作為舊用戶端相容別名仍可使用,新串接統一使用 created_at_from / created_at_to。日期形式的 created_at_to 會包含該自然日,即依下一日零點作為邊界。

請求範例

查詢北京時間本月每日/API 彙總,並附帶模型維度:
查詢指定 Application 的一週用量:
Python 範例:

回應範例

回應欄位

額度單位取決於相關 Application 的 service.unit。若查詢包含不同單位的服務,請先依 service_id 或 application_id 分開統計,避免直接比較或相加。 結束時間不大於開始時間時,介面傳回完整空結構:items=[]、total=0、apis={}、requests=0、models=[]。

錯誤與效能建議

  • 預設不要開啟 include_models;只有報表確實需要模型拆分時再啟用。
  • 大範圍查詢優先依 service_id 或 application_id 分開,既避免混合單位,也降低查詢成本。
  • 沒有呼叫的日期不會自動補零,繪圖前由用戶端補齊日期軸。

下一步