メインコンテンツへスキップ
現在のアカウントの API 呼び出し明細を CSV として直接ダウンロードします。財務照合、オフライン分析、または大量の記録の保存に適しています。ページ上で少数の明細のみを確認する場合は、先に呼び出し記録リストをご利用ください。 呼び出し記録と請求サマリーの照会範囲は直近 60 日間です。リクエストおよびレスポンス本文は、直近 30 日間のみ個別に保持されます。本文の期限切れは、その記録の実際の課金、使用量、または集計統計を変更しません。

準備作業

  1. AceDataCloud プラットフォームにログインします。
  2. Account Token コンソールでアカウントトークンを作成し、直ちにパスワードマネージャーまたは Secret Manager に保存します。
  3. 必要に応じて、サービス申請リスト、API 認証情報リスト、またはAPI リストからフィルター ID を取得します。
トークンの完全な説明については、アカウントトークンの管理をご覧ください。アカウントトークンと業務 API を呼び出すための Credential は混用できません。

API 概要

この API は CSV を同期的にストリーミングで返し、エクスポートタスクを作成せず、JSON やダウンロードリンクも返しません。開始時刻と終了時刻の両方が提供されない場合にのみ、現在の暦月の開始から現在時刻までの記録をデフォルトでエクスポートします。片側の境界のみを指定した場合、もう一方が当月の境界で自動補完されることはありません。

クエリパラメータ

エクスポート範囲は常に、現在のアカウントが支払主体および/または実際の呼び出し元として閲覧できる記録に制限され、アカウントをまたぐエクスポートはサポートされません。

リクエスト例

現在の月の CSV を直接保存する場合:
Application、時刻、ステータスコードでエクスポートする場合:
Python でストリーミング保存し、完全性を確認する場合:

CSV 列

CSV ヘッダーの順序は次のとおり固定されています:
クォータの単位は、対応する Application の service.unit によって決まります。

エクスポートが完全かどうかの判定

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

エラーと再試行

次のステップ