跳轉到主要內容
將目前帳戶的 API 呼叫明細直接下載為 CSV,適合財務對帳、離線分析或儲存大量紀錄。若只需在頁面中查看少量明細,請先使用呼叫紀錄列表。 呼叫紀錄和計費摘要的查詢範圍為最近 60 天;請求與回應本文個別保留最近 30 天。本文到期不會改變該紀錄的實際扣費、用量或彙總統計。

準備工作

  1. 登入 AceDataCloud 平台。
  2. 在 Account Token 控制台建立帳戶權杖,並立即儲存到密碼管理器或 Secret Manager。
  3. 視需要從服務申請列表、API 憑證列表或API 列表取得篩選 ID。
完整權杖說明見管理帳戶權杖。帳戶權杖與呼叫業務 API 的 Credential 不可混用。

介面概覽

本介面同步串流回傳 CSV,不會建立匯出任務,也不回傳 JSON 或下載連結。只有當起訖時間都未提供時,才預設匯出目前自然月開始至目前時刻的紀錄;僅提供一側邊界時,另一側不會自動補為本月邊界。

查詢參數

匯出範圍始終限制在目前帳戶作為付款主體和/或實際呼叫者可見的紀錄,不支援跨帳戶匯出。

請求範例

直接儲存目前月份 CSV:
依 Application、時間和狀態碼匯出:
Python 串流儲存並檢查完整性:

CSV 欄位

CSV 表頭順序固定為:
額度單位由對應 Application 的 service.unit 決定。

判斷匯出是否完整

單次最多輸出 1,000,000 筆資料。伺服器已經開始回傳 CSV 後,無法再將中途錯誤改為其他 HTTP 狀態,因此用戶端必須檢查最後一行:
  • # truncated::達到筆數上限;依較小時間視窗分段匯出。
  • # error::串流讀取中斷;縮小範圍後重新匯出。
對帳程式看到任一 marker 都必須將檔案視為不完整,不能靜默入帳。

錯誤與重試

下一步