GET (/users/{userId}/profile/settings/people/{userList})

项目
05/09/2023

获取一个或多个具有人脉名字对象支持的用户的档案。这些 URI 的域是 profile.xboxlive.com。

备注
URI 参数
查询字符串参数
必需请求标头
请求正文

备注

userList 和 userIds 是互斥参数。如果同时指定或指定其中一个，你将重新收到 BadRequest。 userList 是在有多个对请求有用的命名列表场景中用于适应未来情况的数组。 userIds 由 XUID 的十六进制字符串组成 - JSON 在序列化 64 位无符号整数时无效。最后，Xbox One 中的设置将是命名设置，具有正常的用户可读名称，而不是 64 位无符号整数或模糊常量（如 XONLINE_PROFILE_ASDF）。

URI 参数

参数	类型	说明
userId	字符串	可以是“xuid(12345)”、“gt(myGamertag)”或“me”。
userList	字符串	要获取其设置的命名人员列表。目前，人员是唯一支持的列表。

查询字符串参数

参数	类型	说明
设置	字符串	逗号分隔的设置名称的列表。

必需请求标头

标头	类型	说明
x-xbl-contract-version	32 位有符号整数	值 = 2
Content-Type	字符串	值 = `application/json`

请求正文

示例请求

GET /users/me/profile/settings/people/people?settings=GameDisplayName,GameDisplayPicRaw,Gamerscore,Gamertag

响应正文

响应是 ReadMultiSettingsResponseV2 对象。假设调用用户只有一个好友：

{
      "profileUsers":[
         {
            "id":"2533274791381930",
            "settings":[
               {
                  "id":"GameDisplayName",
                  "value":"John Smith"
               },
               {
                  "id":"GameDisplayPicRaw",
                  "value":"http://images-eds.xboxlive.com/image?url=z951ykn43p4FqWbbFvR2Ec.8vbDhj8G2Xe7JngaTToBrrCmIEEXHC9UNrdJ6P7KIN0gxC2r1YECCd3mf2w1FDdmFCpSokJWa2z7xtVrlzOyVSc6pPRdWEXmYtpS2xE4F&format=png&w=64&h=64"
               },
               {
                  "id":"Gamerscore",
                  "value":"0"
               },
               {
                  "id":"Gamertag",
                  "value":"CracklierJewel9"
               }
            ]
         }
      ]
   }

另请参阅

父级

/users/{userId}/profile/settings/people/{userList}?settings={settings}

Profile (JSON)

通过