/api/v2/server-side-api/vc/balances/ 仮想通貨の残高一覧を取得する
プロファイルのすべての仮想通貨の現在の残高を返します。アプリに仮想通貨が存在しない場合、data は空の配列になります。
Header parameters
お客様のシステムにおける顧客の一意のID。adapty-customer-user-id または adapty-profile-id のいずれかが必須です。
お客様のシステムにおけるプロファイルの一意のID。匿名プロファイルを扱う場合に最適な選択肢です。adapty-customer-user-id または adapty-profile-id のいずれかが必須です。
Responses
残高が正常に返されました
Schema
プロファイルのすべてのバーチャル通貨の現在の残高。
レスポンスが生成された日時(Unixタイムスタンプ、ミリ秒単位)。
アプリ内で一意の仮想通貨コード。ASCII文字、数字、アンダースコアが使用可能です。
仮想通貨の表示名。
現在保留中の金額を含む合計残高。
すべてのアクティブな保留(予約済み金額)の合計。現在は常に0です。
支出可能な残高。balance - held として算出されます。
Example
{
"response_created_at": 1779791400000,
"data": [
{
"code": "COINS",
"name": "Gold Coins",
"balance": 12450,
"held": 0,
"available": 12450
},
{
"code": "GEMS",
"name": "Gems",
"balance": 3280,
"held": 0,
"available": 3280
},
{
"code": "ENERGY",
"name": "Energy",
"balance": 840,
"held": 0,
"available": 840
}
]
} リクエストが不正です。adapty-profile-id も adapty-customer-user-id も送信されていません(error_code は validation_error)。
Schema
エラーの発生源
エラーメッセージの配列
エラーの短い名称
HTTPステータスコード
認証されていません。APIキーが存在しないか無効です(error_code は not_authenticated)。
Schema
エラーの発生源
エラーメッセージの配列
エラーの短い名称
HTTPステータスコード
プロファイルが見つかりません(error_code は profile_does_not_exist)。
Schema
エラーの発生源
エラーメッセージの配列
エラーの短い名称
HTTPステータスコード
内部サーバーエラー