> ## 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 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](#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 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'<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| chaîne| ID unique pour 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 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.

<a id="ID4ENC" />

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

<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-CA/reference/live/rest/uri/marketplace/uri-inventoryconsumablesitemurl)

<a id="ID4ELD" />

##### Informations supplémentaires

[En-têtes communs d'EDS](/fr-CA/reference/live/rest/additional/edscommonheaders)

[Paramètres d'EDS](/fr-CA/reference/live/rest/additional/edsparameters)

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

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

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


## Related topics

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