仮想通貨クイックスタート

メイン記事: 仮想通貨

このクイックスタートでは、トークン通貨をエンドツーエンドでセットアップします。サブスクリプションによってユーザーに毎月1000トークンが付与され、アプリ内の有料アクションでトークンを消費します。Adaptyがすべての残高を管理するため、バックエンドは残高の読み取りと消費のみを行います。

仮想通貨を作成するガイドに従って、TOKENS通貨を作成します。Proサブスクリプションにリンクし、Credit per cycleを1000に設定します。追加トークンを販売するには、買い切り型のトークンパックプロダクトもリンクします。
仮想通貨残高の一覧を取得するを呼び出して、たとえばコンテンツ生成を開始する前にユーザーの残高を確認します。

   curl https://api.adapty.io/api/v2/server-side-api/vc/balances/ \
     -H "Authorization: Api-Key {your secret key}" \
     -H "adapty-customer-user-id: user-42"

レスポンスには、ユーザーが保有するすべての通貨が表示されます。たとえば TOKENS が 1000 の場合:

   {
     "data": [
       { "code": "TOKENS", "name": "Tokens", "balance": 1000, "held": 0, "available": 1000 }
     ]
   }

ユーザーが生成を実行したら、負の amount を指定して仮想通貨トランザクションの作成を呼び出してトークンを消費します。この例では、画像1枚の生成に100トークンかかります：

curl -X POST https://api.adapty.io/api/v2/server-side-api/vc/transactions/ \
  -H "Authorization: Api-Key {your secret key}" \
  -H "adapty-customer-user-id: user-42" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"currency_code": "TOKENS", "amount": -100}]}'

トランザクションはアトミックで、更新後の残高を返します。ユーザーがコストを賄えない場合、リクエストは insufficient_balance を返し、何も変更されません。リクエストを安全に再試行するには、Idempotency-Key ヘッダーを含めてください。 4. ウィンバックプロモを実施するには、同じエンドポイントで正の amount を指定してトークンを付与します。この方法で付与したクレジットは有効期限がありません。 5. ユーザーのプロファイルやトランザクション履歴のすべての変更を確認することで、いつでもエコノミーを監査できます。