GET (/users/me/inventory)

Fornece ao chamador o conjunto de inventário atualmente associado ao usuário fornecido. O domínio desses URIs é inventory.xboxlive.com.

Comentários
Parâmetros da cadeia de consulta
Exemplo de solicitação
Corpo da resposta

Comentários

Nenhuma verificação, imposição ou filtragem de política ocorrerá como parte desta chamada. Os chamadores têm a opção de passar parâmetros de consulta para restringir o escopo dos resultados retornados. Os chamadores podem paginar os resultados com um token de continuação fornecido por uma resposta anterior: /users/me/inventory?continuationToken=continuationTokenString. O chamador pode fazer uma chamada à API de detalhes com a URL de um item específico para ver informações sobre esse item.

Parâmetros da cadeia de consulta

Parâmetro	Tipo	Descrição
availability	string	A disponibilidade atual dos itens a serem retornados. O padrão é “Available”, que retorna os itens para os quais a data atual está entre a data de início e a data de término. Outros valores incluem “All”, que retorna todos os itens, e “Unavailable”, que retorna os itens para os quais a data atual está fora do intervalo entre a data de início e a data de término e que, portanto, não estão disponíveis no momento.
container	string	Opcional. Se você definir o valor como a ID do produto de um jogo, os resultados do inventário incluirão apenas os itens relacionados a esse jogo. Isso é especialmente útil ao chamar o inventário a partir do seu servidor para filtrar os resultados aos produtos de um jogo específico.
expandSatisfyingEntitlements	string	Um sinalizador que indica se a resposta inclui todos os direitos satisfatórios que o usuário tem dentro dos resultados retornados. O padrão é “false”. Quando esse parâmetro é usado com o valor “true”, todos os produtos concedidos ao usuário por meio de direitos satisfatórios, como itens incluídos em pacotes, compras do XBOX 360 migradas para o XBOX One, benefícios de assinatura etc., são adicionados aos resultados. Quando esse valor é “false”, apenas os itens pai, como o ProductID do pacote, são retornados nos resultados, e não os itens individuais incluídos. Observação: o uso desse parâmetro com o valor “true” só é compatível se o parâmetro itemType não estiver incluído no URI; caso contrário, você receberá um erro HTTP 400.
productIds	string	Uma coleção de ProductIds que você deseja recuperar especificamente do inventário do usuário, separados por ’,’. Se o usuário não tiver um ProductID fornecido nos resultados do inventário, esse item não aparecerá nos resultados da chamada à API. Se você passar o productID de um pacote junto com o parâmetro expandSatisfyingEntitlements definido como true, todos os itens incluídos no pacote serão retornados nos resultados da chamada (independentemente de você ter especificado os productIds deles na cadeia de consulta ou não).
state	string	O estado dos itens a serem retornados. O padrão é “all”, que retorna todos os itens. Outros valores são “Enabled”, que indica que somente os itens habilitados devem ser retornados, “Suspended”, que indica que somente os itens suspensos devem ser retornados, “Expired”, que indica que somente os itens expirados devem ser retornados, “Cancelled”, que indica que somente os itens cancelados devem ser retornados, e “Renewed”, que indica que somente os itens renovados devem ser retornados.

Além desses, o recurso dá suporte à mecânica de paginação padrão.

Exemplo de solicitação

O nome de domínio totalmente qualificado para este método de URI é https://inventory.xboxlive.com/users/me/inventory.

Observação:
Os usuários considerados dependem do token fornecido, que pode incluir vários usuários. Se você quiser o inventário de um único usuário, também deverá fornecer o hash de usuário do usuário específico que deseja considerar exclusivamente.

Corpo da resposta

Se a chamada for bem-sucedida, o serviço retornará uma matriz de itens de inventário. Consulte inventoryItem (JSON).

Exemplo de resposta

{
  "pagingInfo": {
    "continuationToken": string,
    "totalItems": int
  },
  "items":
  {
    "url": string,
    "itemType": "Music",
    "titleId": string,
    "containers": string,
    "obtained": DateTime,
    "startDate": DateTime,
    "endDate": DateTime,
    "state": "Enabled"  
}

Confira também

Pai

/users/me/inventory

Mais informações

Cabeçalhos comuns do EDS Parâmetros do EDS Refinadores de consulta do EDS URIs do Marketplace Referência adicional

Porting

Build Paths

GET (/users/me/inventory)

GET (/users/me/inventory)

Comentários

Parâmetros da cadeia de consulta

Exemplo de solicitação

Corpo da resposta

Exemplo de resposta

Confira também

Pai

Mais informações

​GET (/users/me/inventory)

​Comentários

​Parâmetros da cadeia de consulta

​Exemplo de solicitação

​Corpo da resposta

​Exemplo de resposta

​Confira também

Pai

Mais informações

GET (/users/me/inventory)

Comentários

Parâmetros da cadeia de consulta

Exemplo de solicitação

Corpo da resposta

Exemplo de resposta

Confira também