> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # GET (/users/xuid({xuid})/achievements) > GET (/users/xuid({xuid})/achievements) # GET (/users/xuid({xuid})/achievements) Obtém a lista de conquistas definidas no título, as desbloqueadas pelo usuário ou as que o usuário tem em andamento. O domínio desses URIs é `achievements.xboxlive.com`. * [Parâmetros de URI](#ID4EX) * [Parâmetros da cadeia de caracteres de consulta](#ID4ECB) * [Autorização](#ID4ENF) * [Cabeçalhos de solicitação obrigatórios](#ID4ESG) * [Cabeçalhos de solicitação opcionais](#ID4ESH) * [Corpo da solicitação](#ID4EIBAC) * [Corpo da resposta](#ID4ETBAC) ## Parâmetros de URI | Parâmetro | Tipo | Descrição | | - | - | - | | xuid | inteiro sem sinal de 64 bits | ID de usuário do XBOX (XUID) do usuário cujo (recurso) está sendo acessado. Deve corresponder ao XUID do usuário autenticado. | ## Parâmetros da cadeia de caracteres de consulta \| Parâmetro| Obrigatório| Tipo| Descrição| \| --- | --- | --- | --- | --- | --- | --- | \| skipItems| Não| inteiro com sinal de 32 bits| Retorna itens começando após o número de itens fornecido. Por exemplo, skipItems="3" recuperará itens a partir do quarto item recuperado. | \| continuationToken| Não| string| Retorna os itens a partir do token de continuação fornecido. | \| maxItems| Não| inteiro com sinal de 32 bits| 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 que maxItems, mesmo que a última página de resultados ainda não tenha sido retornada. | \| titleId| Não| string| Um filtro para os resultados retornados. Aceita um ou mais identificadores de título decimais delimitados por vírgula.| \| unlockedOnly| Não| Valor booliano| Filtro para os resultados retornados. Se definido como true, retornará apenas as conquistas desbloqueadas para o usuário. O padrão é false.| \| possibleOnly| Não| Valor booliano| Filtro para os resultados retornados. Se definido como true, retornará todos os resultados possíveis, mas não os metadados de desbloqueio, apenas as informações de conquista do XMS. O padrão é false.| \| types| Não| string| Um filtro para os resultados retornados. Pode ser "Persistent" ou "Challenge". O padrão são todos os tipos com suporte.| \| orderBy| Não| string| Especifica a ordem em que os resultados serão retornados. Pode ser "Unordered", "Title", "UnlockTime" ou "EndingSoon". O padrão é "Unordered".| ## 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 obrigatórios \| Cabeçalho| Tipo| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| Authorization| string| Credenciais de autenticação para autenticação HTTP. Valor de exemplo: "XBL3.0 x=\;\".| ## Cabeçalhos de solicitação opcionais \| Cabeçalho| Tipo| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| X-RequestedServiceVersion| string| Nome/número de 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. Valor padrão: 1.| \| x-xbl-contract-version| inteiro sem sinal de 32 bits| Se presente e definido como 2, a versão V2 desta API será usada. Caso contrário, a V1.| \| Accept-Language| string| Lista de localidades desejadas e alternativas (por exemplo, fr-FR, fr, en-GB, en-WW, en-US). O serviço Achievements percorrerá a lista até encontrar cadeias de caracteres localizadas correspondentes. Se nenhuma for encontrada, ele tentará corresponder ao local definido no token do usuário, que vem do endereço IP do usuário. Se ainda assim nenhuma cadeia de caracteres localizada correspondente for encontrada, ele usará as cadeias de caracteres padrão fornecidas pelo desenvolvedor/editor do título. | ## Corpo da solicitação Nenhum objeto é enviado no corpo desta solicitação. ## Corpo da resposta Se a chamada for bem-sucedida, o serviço retornará uma matriz de objetos [Achievement (JSON)](/pt-BR/reference/live/rest/json/json-achievementv2) e um objeto [PagingInfo (JSON)](/pt-BR/reference/live/rest/json/json-paginginfo). ### Exemplo de resposta ```cpp theme={null} { "achievements": [{ "id":"3", "serviceConfigId":"b5dd9daf-0000-0000-0000-000000000000", "name":"Default NameString for Microsoft Achievements Sample Achievement 3", "titleAssociations": [{ "name":"Microsoft Achievements Sample", "id":3051199919, "version":"abc" }], "progressState":"Achieved", "progression": { "achievementState":"Achieved", "requirements":null, "timeUnlocked":"2013-01-17T03:19:00.3087016Z", }, "mediaAssets": [{ "name":"Icon Name", "type":"Icon", "url":"http://www.xbox.com" }], "platform":"D", "isSecret":true, "description":"Default DescriptionString for Microsoft Achievements Sample Achievement 3", "lockedDescription":"Default UnachievedString for Microsoft Achievements Sample Achievement 3", "productId":"12345678-1234-1234-1234-123456789012", "achievementType":"Challenge", "participationType":"Individual", "timeWindow": { "startDate":"2013-02-01T00:00:00Z", "endDate":"2100-07-01T00:00:00Z" }, "rewards": [{ "name":null, "description":null, "value":"10", "type":"Gamerscore", "valueType":"Int" }, { "name":"Default Name for InAppReward for Microsoft Achievements Sample Achievement 3", "description":"Default Description for InAppReward for Microsoft Achievements Sample Achievement 3", "value":"1", "type":"InApp", "valueType":"String" }], "estimatedTime":"06:12:14", "deeplink":"aWFtYWRlZXBsaW5r", "isRevoked":false }], "pagingInfo": { "continuationToken":null, "totalRecords":1 } } ``` ## Confira também ##### Pai [/users/xuid({xuid})/achievements](/pt-BR/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsv2) ##### Referência [Achievement (JSON)](/pt-BR/reference/live/rest/json/json-achievementv2) [PagingInfo (JSON)](/pt-BR/reference/live/rest/json/json-paginginfo) [Parâmetros de paginação](/pt-BR/reference/live/rest/additional/pagingparameters) ## Related topics - [XblAchievementsGetAchievementAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementasync.md) - [XblAchievementsGetAchievementsForTitleIdAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md) - [XblAchievementsResultGetNextAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetnextasync.md) - [XblAchievementsUpdateAchievementAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)