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. Le SandboxId est désormais récupéré à partir de la revendication du XToken et appliqué. Si le SandboxId n’est pas présent, Entertainment Discovery Services (EDS) génère une erreur 400 Bad Request.

​
Paramètres d’URI

​
Autorisation

| Type| Obligatoire| Description| Réponse si absent| | --- | --- | --- | --- | --- | --- | --- | | XUID| Oui| ID d’utilisateur XBOX (XUID) de l’appelant| 403 Forbidden| | titleId| Oui| titleId du titre| 403 Forbidden| | deviceId| Oui pour tous sauf Windows et le Web| deviceId de l’appelant| 403 Forbidden| | deviceType| Oui pour tous sauf le 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| chaîne| Informations d’identification pour l’authentification HTTP. Exemple de valeur : “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| chaîne| Nom ou numéro de build du service XBOX LIVE auquel cette requête doit être dirigée. La requête ne sera acheminée vers ce service qu’après vérification de la validité de l’en-tête, des revendications du jeton d’authentification, et ainsi de suite. Exemples de valeurs : 3, vnext.| | Content-Type| chaîne| Le type MIME du corps de la requête. Exemple de valeur : application/json.| | Content-Length| chaîne| La longueur du corps de la requête. Exemple de valeur : 312.| | Host| chaîne| 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 ou numéro de build du service XBOX LIVE auquel cette requête doit être dirigée. La requête ne sera acheminée vers ce service qu’après vérification de la validité de l’en-tête, des revendications du jeton d’authentification, et ainsi de suite. Valeur par défaut : 1.|

​
Corps de la requête

L’objet de la 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 seront 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 renseignements d’erreur appropriés sont retournés dans le corps de la réponse.

​
Voir aussi

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