Saltar al contenido principal

​
POST (/users/xuid()/devices/current/titles/current)

Actualiza un título con la presencia de un usuario. El dominio de estos URI es userpresence.xboxlive.com.

​
Comentarios

Todos los títulos de las plataformas que no son de consola pueden usar este URI para agregar y actualizar los datos de presencia, presencia enriquecida y presencia multimedia de un título. SandboxId ahora se recupera de la notificación del XToken y se aplica. Si SandboxId no está presente, Entertainment Discovery Services (EDS) generará un error 400 Solicitud incorrecta.

​
Parámetros de URI

​
Autorización

| Tipo| Obligatorio| Descripción| Respuesta si falta| | --- | --- | --- | --- | --- | --- | --- | | XUID| Sí| Identificador de usuario de XBOX (XUID) del autor de la llamada| 403 Prohibido| | titleId| Sí| titleId del título| 403 Prohibido| | deviceId| Sí para todos excepto Windows y web| deviceId del autor de la llamada| 403 Prohibido| | deviceType| Sí para todos excepto web| deviceType del autor de la llamada| 403 Prohibido| | sandboxId| Sí para las llamadas procedentes de | sandbox del autor de la llamada| 403 Prohibido|

​
Encabezados de solicitud obligatorios

| Encabezado| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| Credenciales de autenticación para la autenticación HTTP. Valor de ejemplo: “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| string| Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valores de ejemplo: 3, vnext.| | Content-Type| string| Tipo MIME del cuerpo de la solicitud. Valor de ejemplo: application/json.| | Content-Length| string| Longitud del cuerpo de la solicitud. Valor de ejemplo: 312.| | Host| string| Nombre de dominio del servidor. Valor de ejemplo: presencebeta.xboxlive.com.|

​
Encabezados de solicitud opcionales

| Encabezado| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valor predeterminado: 1.|

​
Cuerpo de la solicitud

El objeto de solicitud es un TitleRequest. Solo se actualizan las propiedades que están realmente presentes en el cuerpo. Las propiedades que no forman parte del cuerpo pero existen en el servidor no se modificarán.

​
Solicitud de ejemplo

​
Cuerpo de la respuesta

En caso de éxito, se devuelve un código de estado HTTP 200 o 201 Creado, según corresponda. En caso de error (HTTP 4xx o 5xx), se devuelve la información de error adecuada en el cuerpo de la respuesta.

​
Consulte también

Elemento primario
/users/xuid()/devices/current/titles/current
Información adicional
URI de Marketplace Referencia adicional
Última modificación el 19 de octubre de 2026