準備作業
- AceDataCloud プラットフォームにログインします。
- Account Token コンソールでアカウントトークンを作成します。
- 一般ユーザーは
user_id=meを使用します。GET /api/v1/platform-tokens/me/から自身の UUID を取得することもできます。
API 概要
一般ユーザーは
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、allow_overdraft;scopeの実際の値はIndividualまたはGlobal;typeの実際の値はUsageまたはPeriod。
allow_overdraft は管理者が制御する読み取り専用のブールフィールドであり、デフォルトは false です。透過が有効化されている従量制(Usage)アプリケーションでは、残高不足でも呼び出しはブロックされず、実際の使用量に応じて引き続き課金されます。負の残高は、決済待ちの利用枠を表します。無効化、有効期限切れ、および API 認証情報の上限は引き続き有効です。
remaining_amount は空である可能性があります。クライアントは数値比較を行う前に、必ず null を確認する必要があります。利用枠の単位は service.unit によって決まります。

