準備作業
- AceDataCloud プラットフォームにログインします。
- Account Token コンソールでアカウントトークンを作成し、直ちに保存します。
- 範囲を絞り込む必要がある場合は、サービス申請リスト、API 認証情報リスト、またはAPI リストから対応する ID を取得します。
API 概要
クエリパラメータ
start_time / end_time は旧クライアントとの互換性エイリアスとして引き続き使用できますが、新規連携では created_at_from / created_at_to を統一して使用してください。日付形式の created_at_to はその暦日を含み、翌日の午前 0 時を境界とします。
リクエスト例
北京時間で当月の日次/API 集計を照会し、モデル次元も含めます。レスポンス例
レスポンスフィールド
クレジットの単位は、関連する Application の
service.unit によって異なります。クエリに異なる単位のサービスが含まれる場合は、直接比較または加算しないよう、まず service_id または application_id ごとに分けて集計してください。
終了時刻が開始時刻以下の場合、API は完全な空構造を返します:items=[]、total=0、apis={}、requests=0、models=[]。
エラーとパフォーマンスに関する推奨事項
- デフォルトでは
include_modelsを有効にしないでください。レポートでモデル別の内訳が実際に必要な場合のみ有効にしてください。 - 広範囲のクエリは、
service_idまたはapplication_idごとに分けることを優先してください。単位の混在を避けるだけでなく、クエリコストも削減できます。 - 呼び出しがない日付は自動的にゼロ埋めされません。グラフを作成する前に、クライアント側で日付軸を補完してください。
次のステップ
- 利用履歴を確認する:集計結果を構成する明細を特定します。
- 利用量をエクスポートする:完全な CSV 明細をダウンロードします。
- サービス申請の詳細を確認する:残高と単位を確認します。

