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

メイン記事: 仮想通貨

このクイックスタートでは、トークン通貨をエンドツーエンドでセットアップします。サブスクリプションによってユーザーに毎月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. ユーザーのプロファイルまたはトランザクション履歴で変更内容を確認すれば、いつでも経済状況を監査できます。