跳轉到主要內容
查詢目前帳戶最近 60 天的業務 API 呼叫明細,適合核對扣費、定位失敗請求,以及依服務、Application、API 或憑證排查問題。
本頁查詢的是帳戶自己的呼叫流水。若只想查看某個 API 在整個平台上的公開呼叫統計,請使用API 呼叫統計。

資料保留範圍

呼叫紀錄及計費摘要保留最近 60 天;請求與回應本文保留最近 30 天。30–60 天的紀錄仍可查詢 trace、狀態、時間、模型、用量和實際扣費等摘要,詳情中的 metadata.request、metadata.response 不再回傳。模型彙總及有效結果統計所需的摘要會在本文到期前保留。需要長期留存本文時,請在呼叫時自行儲存。

準備工作

1. 建立帳戶權杖

本介面屬於平台管理 API,需要使用 Account Token(帳戶權杖):
  1. 登入 AceDataCloud 平台。
  2. 開啟 Account Token 控制台。
  3. 點擊「建立」,立即將權杖儲存到密碼管理器或 Secret Manager。
完整說明見管理 AceDataCloud 平台帳戶權杖。帳戶權杖用於 platform.acedata.cloud/api/v1/**;呼叫 api.acedata.cloud/** 業務介面使用的是 API 憑證(Credential),兩者不能混用。
不要把權杖寫入前端程式碼、日誌或公開儲存庫;如果洩漏,請立即在控制台刪除並重建。

2. 準備篩選 ID(選填)

不傳篩選條件即可查看目前帳戶有權查看的紀錄。需要縮小範圍時: 一般使用者無需傳 user_id;若明確傳入,必須與目前帳戶一致,否則回傳 403。管理員可用此參數跨帳戶篩選。

介面概覽

查詢範圍

查詢參數

請求時間早於最近 60 天時,介面回傳 400 欄位驗證錯誤,提示完整呼叫明細僅保留 60 天。

請求範例

查詢最近 100 筆紀錄:
依時間、Application 和失敗狀態篩選:
Python 分頁範例:

回應範例

關鍵欄位

額度單位由對應 Application 的 service.unit 決定,不應預設視為美元。

錯誤與重試

同一組查詢參數最多保留一個進行中的請求。大範圍查詢優先使用一天或更小的視窗,不要以固定間隔疊加相同請求。

下一步