> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # POST (/users/{ownerId}/people/xuids) > POST (/users/{ownerId}/people/xuids) # POST (/users/{ownerId}/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](#ID4EV) * [Paramètres d'URI](#ID4E5) * [Autorisation](#ID4EJB) * [En-têtes de requête obligatoires](#ID4ERC) * [En-têtes de requête facultatifs](#ID4EBE) * [Corps de la requête](#ID4EHF) * [Codes d'état HTTP](#ID4EKH) * [En-têtes de réponse obligatoires](#ID4ENBAC) * [Corps de la réponse](#ID4EZCAC) ## 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 | Paramètre | Type | Description | | - | - | - | | ownerId | chaîne | Identificateur de l'utilisateur dont la ressource est consultée. Doit correspondre à l'utilisateur authentifié. Les valeurs possibles sont « me », xuid({xuid}) ou gt({gamertag}). | ## 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=\;\.| \| 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)](/fr-CA/reference/live/rest/json/json-xuidlist).| ### 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 ```cpp theme={null} { "xuids": [ "2533274790395904", "2533274792986770", "2533274794866999" ] } ``` ## 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](/fr-CA/reference/live/rest/additional/httpstatuscodes). \| 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)](/fr-CA/reference/live/rest/json/json-peoplelist). ### Exemple de réponse ```cpp theme={null} { "people": [ { "xuid": "2603643534573573", "isFavorite": true, "isFollowingCaller": false, "socialNetworks": ["LegacyXboxLive"] }, { "xuid": "2603643534573572", "isFavorite": true, "isFollowingCaller": false, "socialNetworks": ["LegacyXboxLive"] }, { "xuid": "2603643534573577", "isFavorite": false, "isFollowingCaller": false }, ], "totalCount": 3 } ``` ## Voir aussi ##### Parent [/users/{ownerId}/people/xuids](/fr-CA/reference/live/rest/uri/people/uri-usersowneridpeoplexuids) ## Related topics - [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md) - [XblPresenceGetPresenceForSocialGroupAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md) - [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md) - [XblMultiplayerGetActivitiesForSocialGroupAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md) - [People System에서 사람 표시하기](/ko/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)