Skip to main content

​
POST (/users/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

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.

​
Parâmetros de URI

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

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

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

​
Corpo da solicitação

O objeto de solicitação é um 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.

​
Exemplo de solicitação

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

​
Confira também

Pai
/users/xuid()/devices/current/titles/current
Mais informações
URIs do Marketplace Referência adicional
Last modified on October 6, 2026