Skip to main content

POST ()

Indique qu’un élément d’inventaire consommable a été utilisé en tout ou en partie et décrémente la quantité du consommable du montant demandé. Le domaine de ces URI est inventory.xboxlive.com.

Remarques

  • Si la quantité que l’appelant a demandé de consommer dépasse la réserve restante de l’élément, l’appel sera rejeté.
  • La quantité que l’appelant a demandé de consommer doit être un entier positif supérieur à 0. Les appels dont la valeur de consommation est de 0 ou moins seront rejetés.
  • Si l’appelant fournit un ID de transaction vide, la requête sera rejetée.
  • Si elle est disponible, la revendication du titre sera journalisée afin qu’il soit possible de déterminer quel titre signale la consommation.
  • Les POST supplémentaires ayant le même transactionId seront ignorés pendant un certain temps.
Remarque :
L’en-tête x-xbl-contract-version de cette API est « 4 ».

Paramètres d’URI

| Paramètre| Type| Description| | --- | --- | --- | --- | | itemID| chaîne| ID unique pour chaque utilisateur pour un élément d’inventaire individuel|

Corps de la requête

Exemple de requête

Le champ de quantité à retirer permet à l’appelant d’indiquer la quantité de consommable qu’il souhaite retirer de la quantité restante du consommable. Le champ d’ID de transaction permet à l’appelant de réessayer les opérations sur le contenu consommable tout en limitant le risque de comptabiliser deux fois la même utilisation.

Corps de la réponse

La réponse au POST, en supposant qu’il réussisse l’authentification et qu’il se voie attribuer le contexte d’autorisation approprié, est un accusé de réception contenant le même transactionId que celui transmis au service dans la requête POST, l’URL de l’élément consommable et la nouvelle valeur de quantité de l’élément.

Exemple de réponse

Voir aussi

Parent
/users/me/consumables/
Informations supplémentaires
En-têtes communs d’EDS Paramètres d’EDS Affineurs de requête d’EDS URI de Marketplace Référence supplémentaire
Last modified on October 6, 2026