> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 或更低的呼叫將會遭到拒絕。
* 如果呼叫者提供空白的交易識別碼，要求將會遭到拒絕。
* 如果有遊戲宣告，系統會加以記錄，以便判斷是哪個遊戲回報了消耗。
* 在一段時間內，具有相同 transactionId 的其他 POST 將會遭到忽略。

> **注意：**\
> 此 API 的 **x-xbl-contract-version 標頭**為 "4"。

## URI 參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- |
\| itemID| 字串| 每位使用者單一庫存項目的唯一識別碼|

## 要求本文

### 範例要求

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

```

移除數量欄位可讓呼叫者指出要從消耗性項目的剩餘數量中移除的數量。交易識別碼欄位讓呼叫者能夠重試消耗性內容作業，同時降低將同一次使用計算兩次的風險。

## 回應本文

假設 POST 通過驗證並獲指派適當的授權內容，其回應會是一份接收確認，其中包含在 POST 要求中傳遞給服務的相同 transactionId、消耗性項目的 URL，以及該項目的新數量值。

### 範例回應

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

```

## 另請參閱

##### 上層

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

##### 進一步資訊

[EDS 通用標頭](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edscommonheaders.md)

[EDS 參數](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edsparameters.md)

[EDS 查詢精簡器](https://docs.xbox.com/zh-TW/reference/live/rest/additional/edsqueryrefiners.md)

[Marketplace URI](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/atoc-reference-marketplace.md)

[其他參考](https://docs.xbox.com/zh-TW/reference/live/rest/additional/atoc-xboxlivews-reference-additional.md)


## Related topics

- [/users/me/consumables/{itemID}](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-inventoryconsumablesitemurl.md)
- [/inventory/{itemID}](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-inventoryitemurl.md)
- [POST /users/xuid(xuid)/lists/PINS/{listname}/RemoveItems](https://docs.xbox.com/zh-TW/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnameremoveitemspost.md)
- [GET (/inventory/{itemID})](https://docs.xbox.com/zh-TW/reference/live/rest/uri/marketplace/uri-inventoryitemurlget.md)
- [POST /users/xuid(xuid)/lists/PINS/{listname}/ContainsItems](https://docs.xbox.com/zh-TW/reference/live/rest/uri/lists/uri-usersxuidlistspinslistnamecontainsitemspost.md)