> ## 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 se ha usado la totalidad o una parte de un elemento de inventario consumible y disminuye la cantidad del consumible en la cantidad solicitada.
El dominio de estos URI es `inventory.xboxlive.com`.

* [Comentarios](#ID4EX)
* [Parámetros de URI](#ID4EQB)
* [Cuerpo de la solicitud](#ID4E2B)
* [Cuerpo de la respuesta](#ID4ENC)

## Comentarios

* Si la cantidad que el autor de la llamada solicitó consumir supera la cantidad restante del elemento, la llamada se rechazará.
* La cantidad que el autor de la llamada solicitó consumir debe ser un entero positivo mayor que 0. Las llamadas con un valor de consumo de 0 o inferior se rechazarán.
* Si el autor de la llamada proporciona un Id. de transacción vacío, la solicitud se rechazará.
* Si está disponible, la notificación del título se registrará para que sea posible determinar qué título está notificando el consumo.
* Las solicitudes POST adicionales con el mismo transactionId se omitirán durante un período de tiempo.

> **Nota:**\
> El encabezado **x-xbl-contract-version** para esta API es "4".

## Parámetros de URI

\| Parámetro| Tipo| Descripción|
\| --- | --- | --- | --- |
\| itemID| string| Id. único para cada usuario de un elemento de inventario singular|

## Cuerpo de la solicitud

### Ejemplo de solicitud

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

```

El campo de cantidad que se va a quitar permite al autor de la llamada indicar la cantidad de consumible que desea quitar de la cantidad restante del consumible. El campo de Id. de transacción proporciona al autor de la llamada un medio para reintentar operaciones de uso de contenido consumible al tiempo que limita el riesgo de contar dos veces el mismo uso.

## Cuerpo de la respuesta

La respuesta al POST, suponiendo que supera la autenticación y se le asigna el contexto de autorización adecuado, es una confirmación de recepción con el mismo transactionId pasado al servicio en la solicitud POST, la dirección URL del elemento consumible y el nuevo valor de cantidad del elemento.

### Ejemplo de respuesta

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

```

## Consulte también

##### Elemento primario

[/users/me/consumables/{itemID}](https://devdocs.xbox.com/es/reference/live/rest/uri/marketplace/uri-inventoryconsumablesitemurl)

##### Información adicional

[Encabezados comunes de EDS](https://devdocs.xbox.com/es/reference/live/rest/additional/edscommonheaders)

[Parámetros de EDS](https://devdocs.xbox.com/es/reference/live/rest/additional/edsparameters)

[Refinadores de consulta de EDS](https://devdocs.xbox.com/es/reference/live/rest/additional/edsqueryrefiners)

[URI de Marketplace](https://devdocs.xbox.com/es/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[Referencia adicional](https://devdocs.xbox.com/es/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

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