Transactions idempotentes et modèles de nouvelle tentative dans Economy v2

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



```

Si le client ne reçoit pas de réponse (par exemple, en raison d'un délai d'expiration réseau), il peut relancer en toute sécurité exactement la même requête avec le même `IdempotencyId`. PlayFab reconnaît le doublon et retourne le résultat original. Le joueur n'est facturé qu'une seule fois.

## Pratiques exemplaires

- **Générez un ID unique par opération logique** : utilisez un GUID ou un UUID. Ne réutilisez pas le même ID pour des opérations différentes.
- **Générez l'ID côté client avant la première tentative** : cette pratique garantit que toutes les nouvelles tentatives utilisent le même ID.
- **Ne modifiez pas le corps de la requête entre les nouvelles tentatives** : l'utilisation du même `IdempotencyId` avec un corps de requête différent entraîne une erreur de conflit.
- **Les ID expirent après 14 jours** : après ce délai, le même ID peut être réutilisé pour une nouvelle opération.

## Les API d'échange sont automatiquement idempotentes

Les API d'échange des marketplaces (`RedeemAppleAppStoreInventoryItems`, `RedeemGooglePlayInventoryItems`, `RedeemMicrosoftStoreInventoryItems`, `RedeemSteamInventoryItems`) n'exigent pas d'`IdempotencyId`. Elles sont intrinsèquement idempotentes. Chaque reçu ou jeton d'une marketplace ne peut être échangé qu'une seule fois. Un deuxième appel avec le même reçu retourne un succès, mais n'octroie rien.

## Scénarios courants

| Scénario | Approche recommandée |
|---|---|
| Achat côté client (un joueur achète un article) | Générez un GUID avant la première tentative, puis relancez avec le même ID en cas de délai d'expiration. |
| Octroi de récompense côté serveur (quête terminée) | Utilisez un ID déterministe dérivé de la quête et du joueur (par exemple, `questId-playerId`) pour empêcher les octrois en double. |
| Échange sur une marketplace | Aucun `IdempotencyId` requis : les API d'échange sont automatiquement idempotentes. |

## Voir aussi

- [ETags et contrôle de la concurrence](/fr-CA/services/playfab/economy-monetization/economy-v2/tutorials/etags-and-concurrency-control)
- [Vue d'ensemble de l'inventaire](/fr-CA/services/playfab/economy-monetization/economy-v2/inventory#idempotency)
- [Prévention de la fraude](/fr-CA/services/playfab/economy-monetization/economy-v2/fraud-prevention)
- [ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations)