Skip to main content
現在のアカウントの直近 60 日間の業務 API 呼び出し明細を照会します。課金の照合、失敗したリクエストの特定、およびサービス、Application、API、または認証情報ごとの問題調査に適しています。
このページで照会するのはアカウント自身の呼び出し履歴です。特定の API のプラットフォーム全体における公開呼び出し統計のみを確認したい場合は、API 呼び出し統計を使用してください。

事前準備

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 によって決まり、デフォルトで米ドルとして扱うべきではありません。

エラーと再試行

同じ一連のクエリパラメータについて、進行中のリクエストは最大 1 つまで保持されます。広範囲のクエリでは、1 日以下のウィンドウを優先して使用し、固定間隔で同一リクエストを重ねないでください。

次のステップ