メインコンテンツへスキップ
日付と API ごとに、現在のアカウントのリクエスト回数と実際に控除されたクレジットを集計します。月次レポート、トレンドチャート、コスト分析の作成に適しています。レコードを 1 件ずつトラブルシューティングする場合は呼び出し履歴リストを使用し、完全なオフライン明細が必要な場合は呼び出し量エクスポートを使用してください。 呼び出し履歴と請求サマリーの検索範囲は直近 60 日間です。リクエストおよびレスポンス本文は、直近 30 日間のみ個別に保持されます。本文の期限切れは、そのレコードの実際の課金、使用量、または集計統計には影響しません。

準備作業

  1. AceDataCloud プラットフォームにログインします。
  2. Account Token コンソールでアカウントトークンを作成し、直ちに保存します。
  3. 範囲を絞り込む必要がある場合は、サービス申請リスト、API 認証情報リスト、またはAPI リストから対応する ID を取得します。
トークンの完全な説明については、アカウントトークンの管理を参照してください。この API は Account Token を使用し、ビジネス Credential は使用しません。

API 概要

クエリパラメータ

start_time / end_time は旧クライアントとの互換性エイリアスとして引き続き使用できますが、新規連携では created_at_from / created_at_to を統一して使用してください。日付形式の created_at_to はその暦日を含み、翌日の午前 0 時を境界とします。

リクエスト例

北京時間で当月の日次/API 集計を照会し、モデル次元も含めます。
指定した Application の 1 週間の使用量を照会します。
Python の例:

レスポンス例

レスポンスフィールド

クレジットの単位は、関連する Application の service.unit によって異なります。クエリに異なる単位のサービスが含まれる場合は、直接比較または加算しないよう、まず service_id または application_id ごとに分けて集計してください。 終了時刻が開始時刻以下の場合、API は完全な空構造を返します:items=[]、total=0、apis={}、requests=0、models=[]。

エラーとパフォーマンスに関する推奨事項

  • デフォルトでは include_models を有効にしないでください。レポートでモデル別の内訳が実際に必要な場合のみ有効にしてください。
  • 広範囲のクエリは、service_id または application_id ごとに分けることを優先してください。単位の混在を避けるだけでなく、クエリコストも削減できます。
  • 呼び出しがない日付は自動的にゼロ埋めされません。グラフを作成する前に、クライアント側で日付軸を補完してください。

次のステップ