> ## 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/{scid}/{achievementid})

> GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})

# GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})

Obtém os detalhes da conquista.
O domínio desses URIs é `achievements.xboxlive.com`.

* [Parâmetros de URI](#ID4EV)
* [Autorização](#ID4EAB)
* [Efeito das configurações de privacidade no recurso](#ID4E4C)
* [Cabeçalhos de solicitação obrigatórios](#ID4EPG)
* [Cabeçalhos de solicitação opcionais](#ID4EPH)
* [Corpo da solicitação](#ID4ECBAC)
* [Códigos de status HTTP](#ID4ENBAC)
* [Corpo da resposta](#ID4EBGAC)

<a id="ID4EV" />

## 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. |
| scid | GUID | Identificador exclusivo da configuração de serviço cuja conquista está sendo acessada. |
| achievementid | inteiro sem sinal de 32 bits | Identificador exclusivo (dentro do SCID especificado) da conquista que está sendo acessada. |

<a id="ID4EAB" />

## Autorização

Declarações de autorização usadas | Declaração| Obrigatória?| Descrição| Comportamento se ausente|
\| --- | --- | --- | --- | --- | --- | --- |
\| User| Sim| Um usuário válido no XBOX LIVE para quem a solicitação está sendo feita.| 403 Forbidden|
\| Title| Não| O título que faz a chamada.| Depende do AuthZ. Desde 1º de maio de 2013, o AuthZ não fornece uma declaração quando ausente e, portanto, negará acesso a todos os SCIDs não marcados como públicos.|
\| Sandbox| Não| A área restrita da qual os resultados devem ser recuperados.| Depende do AuthZ. Desde 1º de maio de 2013, o AuthZ não fornece uma declaração padrão quando ausente.|

<a id="ID4E4C" />

## Efeito das configurações de privacidade no recurso

Efeito das configurações de privacidade no recurso | Usuário solicitante| Configuração de privacidade do usuário de destino| Comportamento|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| eu| -| Conforme descrito.|
\| amigo| todos| OK|
\| amigo| somente amigos| OK|
\| amigo| bloqueado| Proibido.|
\| usuário não amigo| todos| OK|
\| usuário não amigo| somente amigos| Proibido.|
\| usuário não amigo| bloqueado| Proibido.|
\| site de terceiros| todos| OK|
\| site de terceiros| somente amigos| Proibido.|
\| site de terceiros| bloqueado| Proibido.|

<a id="ID4EPG" />

## 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=\<userhash>;\<token>".|

<a id="ID4EPH" />

## 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 e assim por diante. Valor padrão: 1.|
\| x-xbl-contract-version| string| O padrão é 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. |

<a id="ID4ECBAC" />

## Corpo da solicitação

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

<a id="ID4ENBAC" />

## Códigos de status HTTP

O serviço retorna um dos códigos de status desta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com os XBOX Live Services, confira [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes).

\| Código| Frase de motivo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| A sessão foi recuperada com êxito.|
\| 301| Moved Permanently| O serviço foi movido para um URI diferente.|
\| 307| Temporary Redirect| O URI deste recurso foi alterado temporariamente.|
\| 400| Bad Request| O serviço não conseguiu entender a solicitação malformada. Normalmente, um parâmetro inválido.|
\| 401| Unauthorized| A solicitação requer autenticação do usuário.|
\| 403| Forbidden| A solicitação não é permitida para o usuário ou serviço.|
\| 404| Not Found| O recurso especificado não foi encontrado.|
\| 406| Not Acceptable| A versão do recurso não tem suporte; deve ser rejeitada pela camada MVC.|
\| 408| Request Timeout| A solicitação demorou muito para ser concluída.|
\| 410| Gone| O recurso solicitado não está mais disponível.|

<a id="ID4EBGAC" />

## Corpo da resposta

<a id="ID4EHGAC" />

### Exemplo de resposta

```cpp theme={null}
{
    "achievement":
    {
        "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":
        {
                "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
    }
}
         
```

<a id="ID4ERGAC" />

## Confira também

<a id="ID4ETGAC" />

##### Pai

[/users/xuid({xuid})/achievements/{scid}/{achievementid}](/pt-BR/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid)


## Related topics

- [XblAchievementsGetAchievementAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementasync.md)
- [XblAchievementsGetAchievementsForTitleIdAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
