Skip to main content

POST (/users/xuid()/achievements//update)

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

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.

Parâmetros de URI

Autorização

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

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

Corpo da solicitação

Um objeto AchievementUpdateRequest (JSON).

Exemplo de solicitação

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

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

Corpo da resposta

O corpo da resposta está vazio.

Confira também

Pai
/users/xuid()/achievements//update
Last modified on October 6, 2026