準備作業
- AceDataCloud プラットフォームにログインします。
- Account Token コンソールでアカウントトークンを作成します。
- 一般ユーザーは
user_id=meを使用します。GET /api/v1/platform-tokens/me/から自分の UUID を取得することもできます。
インターフェース概要
一般ユーザーは
user_id=me を渡す必要があります。渡さない場合、クエリは最初にアカウントで絞り込まれず、ページング時に権限のないオブジェクトに遭遇すると 403 が返される可能性があります。管理者は渡さない場合、テーブル全体を確認できます。
クエリパラメータ
paid、disabled、expired、low_balance、および tag は現在サーバー側のフィルタパラメータではありません。残高アラートでは、リストを取得した後、各 Application の remaining_amount、service.unit、および業務しきい値に基づいてクライアント側で判断する必要があります。
リクエスト例
レスポンス説明
レスポンスは{count, items} です。各項目には Application モデルフィールドが含まれ、さらに以下が追加されます：
service：id、alias、title、type、unit、icon_url；credentials：現在の呼び出し元が閲覧権限を持つ認証情報の概要；paid、remaining_amount、used_amount、disabled、allow_consume_global；scopeの実際の値はIndividualまたはGlobal；typeの実際の値はUsageまたはPeriod。
remaining_amount は空の場合があります。クライアントは必ず先に空かどうかを判定してから、数値比較を行う必要があります。クォータ単位は service.unit によって決まります。