> ## 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})

Indica que todo ou parte de um item de inventário consumível foi usado e diminui a quantidade do consumível pelo valor solicitado.
O domínio desses URIs é `inventory.xboxlive.com`.

* [Comentários](#ID4EX)
* [Parâmetros de URI](#ID4EQB)
* [Corpo da solicitação](#ID4E2B)
* [Corpo da resposta](#ID4ENC)

<a id="ID4EX" />

## Comentários

* Se a quantidade que o chamador pediu para consumir exceder o estoque restante do item, a chamada será rejeitada.
* A quantidade que o chamador pediu para consumir deve ser um inteiro positivo maior que 0. Chamadas com um valor de consumo igual ou menor que 0 serão rejeitadas.
* Se o chamador fornecer uma ID de transação vazia, a solicitação será rejeitada.
* Se disponível, a declaração do título será registrada para que seja possível determinar qual título está relatando o consumo.
* POSTs adicionais com o mesmo transactionId serão ignorados por um determinado período.

> **Observação:**\
> O <b>cabeçalho x-xbl-contract-version</b> desta API é "4".

<a id="ID4EQB" />

## Parâmetros de URI

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- |
\| itemID| string| a ID exclusiva de cada usuário para um único item de inventário|

<a id="ID4E2B" />

## Corpo da solicitação

<a id="ID4EBC" />

### Exemplo de solicitação

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

```

O campo de quantidade a remover permite que o chamador indique a quantidade do consumível que deseja remover da quantidade restante do consumível. O campo ID de transação oferece ao chamador um meio de repetir operações de conteúdo consumível, limitando o risco de contar o mesmo uso duas vezes.

<a id="ID4ENC" />

## Corpo da resposta

A resposta ao POST, supondo que ele passe na autenticação e receba o contexto de autorização apropriado, é uma confirmação de recebimento com o mesmo transactionId passado ao serviço na solicitação POST, a URL do item consumível e o novo valor de quantidade do item.

<a id="ID4EVC" />

### Exemplo de resposta

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

```

<a id="ID4E6C" />

## Confira também

<a id="ID4EBD" />

##### Pai

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

<a id="ID4ELD" />

##### Mais informações

[Cabeçalhos comuns do EDS](/pt-BR/reference/live/rest/additional/edscommonheaders)

[Parâmetros do EDS](/pt-BR/reference/live/rest/additional/edsparameters)

[Refinadores de consulta do EDS](/pt-BR/reference/live/rest/additional/edsqueryrefiners)

[URIs do Marketplace](/pt-BR/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[Referência adicional](/pt-BR/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)