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

データ保持範囲

呼び出し記録および課金サマリーは直近 60 日間保持されます。リクエストとレスポンスの本文は直近 30 日間保持されます。30~60 日前の記録についても trace、ステータス、時刻、モデル、使用量および実際の課金額などのサマリーを照会できますが、詳細内の metadata.request、metadata.response は返されなくなります。モデル集計および有効な結果の統計に必要なサマリーは、本文の有効期限前まで保持されます。本文を長期保存する必要がある場合は、呼び出し時にご自身で保存してください。

準備作業

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 日またはそれより小さいウィンドウを優先し、固定間隔で同じリクエストを重ねないでください。

次のステップ