Economy v2의 멱등성 트랜잭션 및 재시도 패턴

​

필수 구성 요소

• PlayFab 개발자 계정.
• Game Manager에서 만든 타이틀.
• 게시된 카탈로그 아이템과 가상 화폐가 각각 하나 이상 있어야 합니다.

​

작동 방식

​

지원되는 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