Skip to main content

​
GET (/users//people/)

Obtient une personne par ID cible dans la collection de personnes de l’appelant. Le domaine de ces URI est social.xboxlive.com.

​
Remarques

Les opérations GET 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>.|

​
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

Aucun objet n’est envoyé dans le corps de cette 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.| | 400| Bad Request| 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.| | 404| Not Found| L’utilisateur cible est introuvable dans la liste People du propriétaire.|

​
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

Si l’appel réussit, le service retourne la personne cible. Consultez Person (JSON).

​
Exemple de réponse

​
Voir aussi

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