Skip to main content

GET (/users/xuid()/history/titles)

Obtém uma lista de títulos nos quais o usuário desbloqueou ou progrediu em suas conquistas. Esta API não retorna o histórico completo de títulos jogados ou iniciados por um usuário. O domínio desses URIs é achievements.xboxlive.com.

Parâmetros de URI

Parâmetros da cadeia de caracteres de consulta

| Parâmetro| Obrigatório| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | | skipItems| Não| inteiro de 32 bits com sinal| Retorna itens a partir do número de itens fornecido. Por exemplo, skipItems=“3” recuperará itens começando pelo quarto item recuperado. | | continuationToken| Não| string| Retorna os itens a partir do token de continuação fornecido. | | maxItems| Não| inteiro de 32 bits com sinal| Número máximo de itens a serem retornados da coleção, que pode ser combinado com skipItems e continuationToken para retornar um intervalo de itens. O serviço pode fornecer um valor padrão se maxItems não estiver presente e pode retornar menos itens do que maxItems, mesmo que a última página de resultados ainda não tenha sido retornada. |

Autorização

| Declaração| Obrigatória?| Descrição| Comportamento se ausente| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | User| O chamador é um usuário autorizado do XBOX LIVE.| O chamador precisa ser um usuário válido no XBOX LIVE.| 403 Forbidden|

Cabeçalhos de solicitação opcionais

| Cabeçalho| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| string| Nome/número do build do serviço XBOX LIVE para o qual esta solicitação deve ser direcionada. A solicitação só será roteada para esse serviço após a verificação da validade do cabeçalho, das declarações no token de autenticação etc.| | x-xbl-contract-version| inteiro de 32 bits sem sinal| Se estiver presente e definido como 2, a versão V2 desta API será usada. Caso contrário, V1.|

Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

Confira também

Pai
/users/xuid()/history/titles
Referência
UserTitle (JSON) PagingInfo (JSON) Parâmetros de paginação
Last modified on October 6, 2026