Skip to main content
將目前帳戶的 API 呼叫明細直接下載為 CSV,適合財務對帳、離線分析或儲存大量紀錄。若只需在頁面中查看少量明細,請先使用呼叫紀錄列表。

準備工作

  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 都必須將檔案視為不完整,不能靜默入帳。

錯誤與重試

下一步