> ## 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)

<a id="ID4EV" />

## 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.

<a id="ID4E5" />

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| ownerId | string | 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}). |

<a id="ID4EJB" />

## 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|

<a id="ID4ERC" />

## 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 : <b>XBL3.0 x=\<userhash>;\<token></b>.|
\| 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 <b>application/json</b>.|

<a id="ID4EBE" />

## 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 <b>application/json</b>.|

<a id="ID4EHF" />

## Corps de la requête

<a id="ID4ENF" />

### Membres obligatoires

\| Membre| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XuidList| Tableau de XUID identifiant les personnes à retourner à partir de la collection de personnes de l'appelant. Consultez [XuidList (JSON)](/fr/reference/live/rest/json/json-xuidlist).|

<a id="ID4EKG" />

### Membres facultatifs

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

<a id="ID4EVG" />

### Membres interdits

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

<a id="ID4EAH" />

### Exemple de requête

```cpp theme={null}
{
    "xuids": [
        "2533274790395904", 
        "2533274792986770", 
        "2533274794866999"
    ]
}
      
```

<a id="ID4EKH" />

## 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/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 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.|

<a id="ID4ENBAC" />

## 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 <b>application/json</b>.|

<a id="ID4EZCAC" />

## 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)](/fr/reference/live/rest/json/json-peoplelist).

<a id="ID4EHDAC" />

### 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
}
         
```

<a id="ID4ERDAC" />

## Voir aussi

<a id="ID4ETDAC" />

##### Parent

[/users/{ownerId}/people/xuids](/fr/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 시스템에서 사람 표시하기](/ko/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)