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 seule fois ou plusieurs fois.

​
Paramètres d’URI

​
Autorisation

| Type| Obligatoire| Description| Réponse si absent| | --- | --- | --- | --- | --- | --- | --- | | XUID| oui| L’appelant possède l’ID d’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é de 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 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, 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 de type application/json.|

​
Corps de la requête

​
Membres obligatoires

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

​
Membres facultatifs

Cette requête ne comporte aucun membre facultatif.

​
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 d’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é de 32 bits| Longueur, en octets, du corps de la réponse. Exemple de valeur : 22.| | Content-Type| chaîne| Type MIME du corps de la réponse. Ce sera toujours application/json.|

​
Corps de la réponse

Un corps de réponse n’est envoyé que lorsque la méthode de la requête est « get ». Il n’y a aucun corps de réponse pour « add » ou « remove ». Si un appel de 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