Transacciones idempotentes y patrones de reintento en Economy v2

​

Requisitos previos

• Una cuenta de desarrollador de PlayFab.
• Un título creado en Game Manager.
• Al menos un artículo de catálogo publicado y una moneda virtual.

​

Funcionamiento

​

API compatibles

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

​

Ejemplo: compra segura con reintento

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

​

Procedimientos recomendados

• Genere un identificador único por operación lógica: use un GUID o UUID. No reutilice el mismo identificador para operaciones diferentes.
• Genere el identificador en el lado cliente antes del primer intento: esta práctica garantiza que todos los reintentos usen el mismo identificador.
• No cambie el cuerpo de la solicitud entre reintentos: usar el mismo IdempotencyId con un cuerpo de solicitud diferente provoca un error de conflicto.
• Los identificadores expiran a los 14 días: después de ese plazo, el mismo identificador puede volver a usarse para una nueva operación.

​

Las API de canje son automáticamente idempotentes

​

Escenarios comunes

​

Consulte también

• ETags y control de simultaneidad
• Información general del inventario
• Prevención del fraude
• ExecuteInventoryOperations