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 cas de délai d'expiration réseau), il peut réessayer en toute sécurité exactement la même requête avec le même `IdempotencyId`. PlayFab reconnaît le doublon et renvoie le résultat d'origine. Le joueur n'est débité qu'une seule fois.

## Bonnes pratiques

- **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 provoque une erreur de conflit.
- **Les ID expirent après 14 jours** : passé 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 places de marché (`RedeemAppleAppStoreInventoryItems`, `RedeemGooglePlayInventoryItems`, `RedeemMicrosoftStoreInventoryItems`, `RedeemSteamInventoryItems`) ne nécessitent pas d'`IdempotencyId`. Elles sont intrinsèquement idempotentes. Chaque reçu ou jeton de place de marché ne peut être échangé qu'une seule fois. Un second appel avec le même reçu renvoie 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 réessayez 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 doubles octrois. |
| Échange sur une place de marché | Aucun `IdempotencyId` n'est nécessaire : les API d'échange sont automatiquement idempotentes. |

## Voir aussi

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