> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST ({itemID})

> POST ({itemID})

# POST ({itemID})

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](#ID4EX)
* [Paramètres d'URI](#ID4EQB)
* [Corps de la requête](#ID4E2B)
* [Corps de la réponse](#ID4ENC)

<a id="ID4EX" />

## 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'<b>en-tête x-xbl-contract-version</b> de cette API est « 4 ».

<a id="ID4EQB" />

## Paramètres d'URI

\| Paramètre| Type| Description|
\| --- | --- | --- | --- |
\| itemID| string| ID unique propre à chaque utilisateur pour un élément d'inventaire individuel|

<a id="ID4E2B" />

## Corps de la requête

<a id="ID4EBC" />

### Exemple de requête

```cpp theme={null}
{
  "transactionId": String
  "removeQuantity": Int
}

```

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.

<a id="ID4ENC" />

## 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.

<a id="ID4EVC" />

### Exemple de réponse

```cpp theme={null}
{
  "transactionId": String
  "url": String
  "newQuantity": Int
}

```

<a id="ID4E6C" />

## Voir aussi

<a id="ID4EBD" />

##### Parent

[/users/me/consumables/{itemID}](/fr/reference/live/rest/uri/marketplace/uri-inventoryconsumablesitemurl)

<a id="ID4ELD" />

##### Informations supplémentaires

[En-têtes courants EDS](/fr/reference/live/rest/additional/edscommonheaders)

[Paramètres EDS](/fr/reference/live/rest/additional/edsparameters)

[Affineurs de requête EDS](/fr/reference/live/rest/additional/edsqueryrefiners)

[URI de la Marketplace](/fr/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[Référence supplémentaire](/fr/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [item_created](/services/playfab/api-references/events/CatalogV2/item-created.md)
- [item_updated](/services/playfab/api-references/events/CatalogV2/item-updated.md)
- [item_deleted](/services/playfab/api-references/events/CatalogV2/item-deleted.md)