Skip to main content

​
POST (/users//people/xuids)

Obtient des personnes par XUID dans la collection de personnes de l’appelant. Le domaine de ces URI est social.xboxlive.com.

​
Remarques

Les opérations POST ne modifient aucune ressource. Elles produisent donc les mêmes résultats, qu’elles soient exécutées une ou plusieurs fois.

​
Paramètres d’URI

​
Autorisation

| Type| Obligatoire| Description| Réponse en cas d’absence| | --- | --- | --- | --- | --- | --- | --- | | XUID| oui| L’appelant dispose de l’ID utilisateur XBOX (XUID) de l’utilisateur.| 401 Unauthorized|

​
En-têtes de requête obligatoires

| En-tête| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| Chaîne. Données d’autorisation pour XBOX LIVE. Il s’agit généralement d’un jeton XSTS chiffré. Exemple de valeur : XBL3.0 x=<userhash>;<token>.| | Content-Length| Entier non signé 32 bits. Longueur, en octets, du corps de la requête. Exemple de valeur : 22.| | Content-Type| Chaîne. Type MIME du corps de la requête. Doit être application/json.|

​
En-têtes de requête facultatifs

| En-tête| 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.| | Accept| Chaîne. Types de contenu (Content-Types) que l’appelant accepte dans la réponse. Toutes les réponses sont au format application/json.|

​
Corps de la requête

​
Membres obligatoires

| Membre| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | XuidList| Tableau de XUID identifiant les personnes à retourner à partir de la collection de personnes de l’appelant. Consultez XuidList (JSON).|

​
Membres facultatifs

Il n’existe aucun membre facultatif pour cette requête.

​
Membres interdits

Tous les autres membres sont interdits dans une requête.

​
Exemple de requête

​
Codes d’état HTTP

Le service retourne l’un des codes d’état de cette section en réponse à une requête effectuée avec cette méthode sur cette ressource. Pour obtenir la liste complète des codes d’état HTTP standard utilisés avec les services XBOX Live, consultez Codes d’état HTTP standard. | Code| Expression de raison| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| Réussite lorsque la méthode est “get”.| | 204| No Content| Réussite lorsque la méthode est “add” ou “remove”.| | 400| Bad Request| Le paramètre de méthode était manquant ou mal formé, ou les ID utilisateur étaient mal formés.| | 403| Forbidden| La revendication XUID n’a pas pu être analysée à partir de l’en-tête d’autorisation.|

​
En-têtes de réponse obligatoires

| En-tête| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length| entier non signé 32 bits| Longueur, en octets, du corps de la réponse. Exemple de valeur : 22.| | Content-Type| string| Type MIME du corps de la réponse. Il s’agit toujours de application/json.|

​
Corps de la réponse

Un corps de réponse n’est envoyé que lorsque la méthode de requête est “get”. Il n’y a pas de corps de réponse pour “add” ou “remove”. Si l’appel de la méthode “get” réussit, le service retourne le nombre total de personnes dans la collection de personnes de l’appelant, ainsi qu’un tableau contenant la collection de personnes de l’appelant. Aucune réponse n’est retournée pour les méthodes “add” et “remove”. Consultez PeopleList (JSON).

​
Exemple de réponse

​
Voir aussi

Parent
/users//people/xuids
Last modified on October 6, 2026