Skip to main content

GET (/users//profile/settings/people/)

获取一个或多个用户的个人资料,支持“人员”代号。 这些 URI 的域为 profile.xboxlive.com。

备注

userList 和 userIds 是互斥参数。如果同时指定两者或指定其中一个,你将收到 BadRequest。userList 是数组,以便在将来存在多个命名列表有用的场景中使用。userIds 由 XUID 的十进制字符串组成——JSON 不适合序列化 64 位无符号整数。最后,在 XBOX One 中,设置将是命名设置,采用常规的人类可读名称,而不是 64 位无符号整数或诸如 XONLINE_PROFILE_ASDF 之类难以理解的常量。

URI 参数

查询字符串参数

| 参数 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | | settings | string | 以逗号分隔的设置名称列表。 |

必需的请求标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version | 32 位有符号整数 | 值 = 2 | | content-type | string | 值 = application/json |

请求正文

示例请求

响应正文
响应为 ReadMultiSettingsResponseV2 对象。假定调用用户仅有一位好友:

另请参阅

父主题
/users//profile/settings/people/?settings= Profile (JSON)
Last modified on October 19, 2026