> ## 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.

# POST (/users/xuid({xuid})/achievements/{scid}/update)

> POST (/users/xuid({xuid})/achievements/{scid}/update)

# POST (/users/xuid({xuid})/achievements/{scid}/update)

Atualiza o progresso de uma conquista.
O domínio desses URIs é `achievements.xboxlive.com`.

* [Parâmetros de URI](#ID4EV)
* [Autorização](#ID4EAB)
* [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)

## Comentários

* Uma chamada bem-sucedida retornará o código de status HTTP 200 com um corpo de resposta vazio.
* Se a chamada não resultar em nenhuma alteração no progresso da conquista (ou seja, ela já está desbloqueada ou está no mesmo percentual de conclusão), a chamada retornará o código de status HTTP 304 com um corpo de resposta vazio.

<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. |

<a id="ID4EAB" />

## Autorização

| 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 |

<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>".|
\| x-xbl-contract-version| 2| Versão do contrato da API.|

<a id="ID4EPH" />

## Cabeçalhos de solicitação opcionais

\| Cabeçalho| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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

Um objeto [AchievementUpdateRequest (JSON)](/pt-BR/reference/live/rest/json/json-achievementupdaterequest).

<a id="ID4EPB" />

### Exemplo de solicitação

`POST /users/xuid({2810000000000000})/achievements/{00000000-0000-0000-0000-000000000000}/update`

```json theme={null}
{
    "action": "progressUpdate",
    "serviceConfigId": "00000000-0000-0000-0000-000000000000",
    "titleId": 0000000000,
    "userId": "2810000000000000",
    "achievements": [
        {
            "id": "1",
            "percentComplete": 100
        }
    ]
}
```

<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.|
\| 304| Not Modified| O progresso da conquista não foi modificado.|
\| 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

O corpo da resposta está vazio.

## Confira também

##### Pai

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


## Related topics

- [XblAchievementsUpdateAchievementAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XblAchievementsManagerUpdateAchievement](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)