Economy v2 のべき等な取引と再試行パターン

​

前提条件

• PlayFab 開発者アカウント。
• Game Manager で作成されたタイトル。
• 少なくとも 1 つの公開済みカタログ アイテムと 1 つの仮想通貨。

​

仕組み

​

サポートされている API

• AddInventoryItems
• SubtractInventoryItems
• PurchaseInventoryItems
• TransferInventoryItems
• DeleteInventoryItems
• UpdateInventoryItems
• ExecuteInventoryOperations

​

例: 再試行を伴う安全な購入

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "{{PlayerID}}"
    },
    "Item": {
        "Id": "{{LaserSwordID}}"
    },
    "Amount": 1,
    "PriceAmounts": [
        {
            "ItemId": "{{DiamondCurrencyID}}",
            "Amount": 5
        }
    ],
    "IdempotencyId": "b7e3f1a2-9c4d-4e8f-a1b2-3c4d5e6f7a8b"
}

​

ベスト プラクティス

• 論理操作ごとに一意の ID を生成します — GUID または UUID を使用します。異なる操作に対して同じ ID を再利用しないでください。
• 最初の試行の前にクライアント側で ID を生成します — これにより、すべての再試行で同じ ID が使用されます。
• 再試行の間にリクエストの本文を変更しないでください — 異なるリクエスト本文で同じ IdempotencyId を使用すると、競合エラーが発生します。
• ID は 14 日後に期限切れになります — その後、新しい操作に対して同じ ID を再度使用できます。

​

Redeem API は自動的にべき等です

​

一般的なシナリオ

​

関連項目

• ETag と同時実行制御
• インベントリの概要
• 不正防止
• ExecuteInventoryOperations