Skip to main content

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

Met à jour un titre avec la présence d’un utilisateur. Le domaine de ces URI est userpresence.xboxlive.com.

​
Remarques

Cet URI peut être utilisé par tous les titres sur les plateformes autres que les consoles pour ajouter et mettre à jour les données de présence, de Rich Presence et de présence multimédia d’un titre. SandboxId est désormais récupéré à partir de la revendication du XToken et appliqué. Si SandboxId est absent, Entertainment Discovery Services (EDS) génère une erreur 400 Bad request.

​
Paramètres d’URI

​
Autorisation

| Type| Obligatoire| Description| Réponse en cas d’absence| | --- | --- | --- | --- | --- | --- | --- | | XUID| Oui| ID utilisateur XBOX (XUID) de l’appelant| 403 Forbidden| | titleId| Oui| titleId du titre| 403 Forbidden| | deviceId| Oui pour tous, sauf Windows et Web| deviceId de l’appelant| 403 Forbidden| | deviceType| Oui pour tous, sauf Web| deviceType de l’appelant| 403 Forbidden| | sandboxId| Oui pour les appels provenant de | sandbox de l’appelant| 403 Forbidden|

​
En-têtes de requête obligatoires

| En-tête| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| Informations d’identification pour l’authentification HTTP. Exemple de valeur : “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| string| Nom/numéro de build du service XBOX LIVE vers lequel cette requête doit être dirigée. La requête n’est acheminée vers ce service qu’après vérification de la validité de l’en-tête, des revendications du jeton d’authentification, etc. Exemples de valeurs : 3, vnext.| | Content-Type| string| Type MIME du corps de la requête. Exemple de valeur : application/json.| | Content-Length| string| Longueur du corps de la requête. Exemple de valeur : 312.| | Host| string| Nom de domaine du serveur. Exemple de valeur : presencebeta.xboxlive.com.|

​
En-têtes de requête facultatifs

| En-tête| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | Nom/numéro de build du service XBOX LIVE vers lequel cette requête doit être dirigée. La requête n’est acheminée vers ce service qu’après vérification de la validité de l’en-tête, des revendications du jeton d’authentification, etc. Valeur par défaut : 1.|

​
Corps de la requête

L’objet de requête est un TitleRequest. Seules les propriétés réellement présentes dans le corps sont mises à jour. Les propriétés qui ne font pas partie du corps mais qui existent sur le serveur ne sont pas modifiées.

​
Exemple de requête

​
Corps de la réponse

En cas de réussite, un code d’état HTTP 200 ou 201 Created est retourné, selon le cas. En cas d’erreur (HTTP 4xx ou 5xx), les informations d’erreur appropriées sont retournées dans le corps de la réponse.

​
Voir aussi

Parent
/users/xuid()/devices/current/titles/current
Informations supplémentaires
URI de la Marketplace Référence supplémentaire
Last modified on October 6, 2026