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

指示消耗性库存项已被全部或部分使用,并按请求的数量减少该消耗品的数量。
这些 URI 的域为 `inventory.xboxlive.com`。

* [备注](#ID4EX)
* [URI 参数](#ID4EQB)
* [请求正文](#ID4E2B)
* [响应正文](#ID4ENC)

## 备注

* 如果调用者要求消耗的数量超过该项的剩余供应量,则调用将被拒绝。
* 调用者要求消耗的数量必须为大于 0 的正整数。消耗值为 0 或更低的调用将被拒绝。
* 如果调用者提供的事务 ID 为空,则请求将被拒绝。
* 如果可用,将记录 title 声明,以便可以确定哪个游戏正在报告消耗。
* 在一段时间内,使用相同 transactionId 的其他 POST 将被忽略。

> **注意:**\
> 此 API 的 **x-xbl-contract-version 标头**为 "4"。

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| itemID | string | 每个用户对应单个库存项的唯一 ID |

## 请求正文

### 请求示例

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

```

remove quantity 字段允许调用者指示希望从消耗品剩余数量中移除的消耗品数量。事务 ID 字段为调用者提供了一种重试使用消耗性内容操作的方法,同时可限制将同一次使用重复计算的风险。

## 响应正文

假设 POST 通过身份验证并被分配了适当的授权上下文,则对该 POST 的响应是一个接收确认,其中包含在 POST 请求中传递给服务的相同 transactionId、消耗性项的 URL 以及该项的新数量值。

### 响应示例

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

```

## 另请参阅

##### 父主题

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

##### 更多信息

[EDS 通用标头](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edscommonheaders)

[EDS 参数](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edsparameters)

[EDS 查询精简器](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edsqueryrefiners)

[Marketplace URIs](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[其他参考](https://devdocs.xbox.com/zh-CN/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)