> ## 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})/devices/current/titles/current)

> POST (/users/xuid({xuid})/devices/current/titles/current)

# POST (/users/xuid({xuid})/devices/current/titles/current)

Atualiza um título com a presença de um usuário.
O domínio desses URIs é `userpresence.xboxlive.com`.

* [Comentários](#ID4EV)
* [Parâmetros de URI](#ID4EEB)
* [Autorização](#ID4EPB)
* [Cabeçalhos de solicitação obrigatórios](#ID4ENE)
* [Cabeçalhos de solicitação opcionais](#ID4ERG)
* [Corpo da solicitação](#ID4ERH)
* [Corpo da resposta](#ID4EKAAC)

<a id="ID4EV" />

## Comentários

Este URI pode ser usado por todos os títulos em plataformas que não são console para adicionar e atualizar os dados de presença, rich presence e presença de mídia de um título.

**SandboxId** agora é recuperado da declaração no XToken e imposto. Se **SandboxId** não estiver presente, o EDS (Entertainment Discovery Services) gerará um erro 400 Bad request.

<a id="ID4EEB" />

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

<a id="ID4EPB" />

## Autorização

\| Tipo| Obrigatório| Descrição| Resposta se ausente|
\| --- | --- | --- | --- | --- | --- | --- |
\| XUID| Sim| ID de usuário do XBOX (XUID) do chamador| 403 Forbidden|
\| titleId| Sim| titleId do título| 403 Forbidden|
\| deviceId| Sim para todos, exceto Windows e Web| deviceId do chamador| 403 Forbidden|
\| deviceType| Sim para todos, exceto Web| deviceType do chamador| 403 Forbidden|
\| sandboxId| Sim para chamadas provenientes de | área restrita do chamador| 403 Forbidden|

<a id="ID4ENE" />

## 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| 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 e assim por diante. Valores de exemplo: 3, vnext.|
\| Content-Type| string| O tipo MIME do corpo da solicitação. Valor de exemplo: application/json.|
\| Content-Length| string| O comprimento do corpo da solicitação. Valor de exemplo: 312.|
\| Host| string| Nome de domínio do servidor. Valor de exemplo: presencebeta.xboxlive.com.|

<a id="ID4ERG" />

## Cabeçalhos de solicitação opcionais

\| Cabeçalho| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion|  | 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 e assim por diante. Valor padrão: 1.|

<a id="ID4ERH" />

## Corpo da solicitação

O objeto de solicitação é um [TitleRequest](/pt-BR/reference/live/rest/json/json-titlerequest). Somente as propriedades realmente presentes no corpo são atualizadas. As propriedades que não fazem parte do corpo, mas existem no servidor, não serão modificadas.

<a id="ID4EAAAC" />

### Exemplo de solicitação

```cpp theme={null}
{
  id:"12341234",
  placement:"snapped",
  state:"active"
}
      
```

<a id="ID4EKAAC" />

## Corpo da resposta

Em caso de êxito, um código de status HTTP 200 ou 201 Created é retornado, conforme apropriado.

Em caso de erro (HTTP 4xx ou 5xx), as informações de erro apropriadas são retornadas no corpo da resposta.

<a id="ID4EVAAC" />

## Confira também

<a id="ID4EXAAC" />

##### Pai

[/users/xuid({xuid})/devices/current/titles/current](/pt-BR/reference/live/rest/uri/presence/uri-usersxuiddevicescurrenttitlescurrent)

<a id="ID4EBBAC" />

##### Mais informações

[URIs do Marketplace](/pt-BR/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[Referência adicional](/pt-BR/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Troubleshoot XBOX Services traffic on PC](/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [Solución de problemas del tráfico de los servicios XBOX en PC](/es/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [在 PC 上排查 XBOX 服务流量问题](/zh-CN/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [PC에서 XBOX 서비스 트래픽 문제 해결](/ko/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [XblAchievementsUpdateAchievementForTitleIdAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementfortitleidasync.md)