> ## 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 이하인 호출은 거부됩니다.
* 호출자가 빈 Transaction ID를 제공하면 요청은 거부됩니다.
* 사용 가능한 경우 어떤 타이틀이 소비를 보고하는지 확인할 수 있도록 title claim이 기록됩니다.
* 동일한 transactionId로 이루어진 추가 POST는 일정 시간 동안 무시됩니다.

> **참고:**\
> 이 API의 **x-xbl-contract-version 헤더**는 "4"입니다.

## URI 매개변수

\| 매개변수| 형식| 설명|
\| --- | --- | --- | --- |
\| itemID| string| 단일 인벤토리 항목에 대해 사용자별로 고유한 ID입니다.|

## 요청 본문

### 샘플 요청

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

```

remove quantity 필드는 호출자가 소비성 항목의 남은 수량에서 제거하고자 하는 소비성 항목의 수량을 나타낼 수 있게 합니다. Transaction ID 필드는 동일한 사용을 두 번 계산할 위험을 줄이면서 소비성 콘텐츠 작업을 사용하여 재시도할 수 있는 수단을 호출자에게 제공합니다.

## 응답 본문

인증을 통과하고 적절한 권한 부여 컨텍스트가 할당되었다는 가정 하에, POST에 대한 응답은 POST 요청에서 서비스로 전달된 것과 동일한 transactionId, 소비성 항목의 URL 및 항목의 새로운 수량 값과 함께 수신 확인을 제공합니다.

### 샘플 응답

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

```

## 참고 항목

##### 상위 항목

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

##### 추가 정보

[EDS Common Headers](https://devdocs.xbox.com/ko/reference/live/rest/additional/edscommonheaders)

[EDS Parameters](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsparameters)

[EDS Query Refiners](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsqueryrefiners)

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

[추가 참조](https://devdocs.xbox.com/ko/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)