POST ()

消費型インベントリアイテムの全部または一部が使用されたことを示し、要求された量だけ消費アイテムの数量を減らします。これらの URI のドメインは inventory.xboxlive.com です。

注釈

注:
この API の x-xbl-contract-version ヘッダーは “4” です。

| パラメーター| 種類| 説明| | --- | --- | --- | --- | | itemID| string| 単一のインベントリアイテムに対してユーザーごとに一意の ID|

{
  "transactionId": String
  "removeQuantity": Int
}

remove quantity フィールドを使用すると、呼び出し元は消費アイテムの残数から削除する数量を指定できます。Transaction ID フィールドは、同じ使用が二重にカウントされるリスクを抑えつつ、消費コンテンツ操作を再試行する手段を呼び出し元に提供します。

POST に対する応答は、認証を通過し適切な承認コンテキストが割り当てられている場合、POST リクエストでサービスに渡されたのと同じ transactionId、消費アイテムの URL、およびアイテムの新しい数量値を含む受信確認となります。

{
  "transactionId": String
  "url": String
  "newQuantity": Int
}