Skip to main content

POST ()

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

Remarques

  • Si la quantité que l’appelant demande à consommer dépasse le stock restant de l’élément, l’appel sera rejeté.
  • La quantité que l’appelant demande à consommer doit être un entier positif supérieur à 0. Les appels avec une valeur de consommation inférieure ou égale à 0 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 de pouvoir déterminer quel titre signale la consommation.
  • Les POST supplémentaires avec 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| string| ID unique propre à 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 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, à condition 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 courants EDS Paramètres EDS Affineurs de requête EDS URI de la Marketplace Référence supplémentaire
Last modified on October 6, 2026