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 回につき最大 1,000,000 件のデータを出力します。サーバーが CSV の返却を開始した後は、途中のエラーを別の HTTP ステータスに変更できないため、クライアントは必ず最終行を確認する必要があります:
  • # truncated::行数上限に到達しています;より小さな時間ウィンドウで分割してエクスポートします。
  • # error::ストリーミング読み取りが中断されました;範囲を縮小して再度エクスポートします。
照合プログラムは、いずれかの marker を検出した場合、必ずファイルを不完全として扱い、黙って計上してはなりません。

エラーと再試行

次のステップ