Skip to main content

POST ()

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

备注

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

URI 参数

请求正文

请求示例

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

响应正文

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

响应示例

另请参阅

父主题
/users/me/consumables/
更多信息
EDS 通用标头 EDS 参数 EDS 查询精简器 Marketplace URIs 其他参考
Last modified on October 19, 2026