Skip to main content

POST ()

Indica que todo ou parte de um item de inventário consumível foi usado e diminui a quantidade do consumível pelo valor solicitado. O domínio desses URIs é inventory.xboxlive.com.

Comentários

  • Se a quantidade que o chamador pediu para consumir exceder o estoque restante do item, a chamada será rejeitada.
  • A quantidade que o chamador pediu para consumir deve ser um inteiro positivo maior que 0. Chamadas com um valor de consumo igual ou menor que 0 serão rejeitadas.
  • Se o chamador fornecer uma ID de transação vazia, a solicitação será rejeitada.
  • Se disponível, a declaração do título será registrada para que seja possível determinar qual título está relatando o consumo.
  • POSTs adicionais com o mesmo transactionId serão ignorados por um determinado período.
Observação:
O cabeçalho x-xbl-contract-version desta API é “4”.

Parâmetros de URI

| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | | itemID| string| a ID exclusiva de cada usuário para um único item de inventário|

Corpo da solicitação

Exemplo de solicitação

O campo de quantidade a remover permite que o chamador indique a quantidade do consumível que deseja remover da quantidade restante do consumível. O campo ID de transação oferece ao chamador um meio de repetir operações de conteúdo consumível, limitando o risco de contar o mesmo uso duas vezes.

Corpo da resposta

A resposta ao POST, supondo que ele passe na autenticação e receba o contexto de autorização apropriado, é uma confirmação de recebimento com o mesmo transactionId passado ao serviço na solicitação POST, a URL do item consumível e o novo valor de quantidade do item.

Exemplo de resposta

Confira também

Pai
/users/me/consumables/
Mais informações
Cabeçalhos comuns do EDS Parâmetros do EDS Refinadores de consulta do EDS URIs do Marketplace Referência adicional
Last modified on October 6, 2026