GET (/users/{ownerId}/people/{targetid})

按目标 ID 获取调用方人脉集合中的人员。这些 URI 的域是 social.xboxlive.com。

备注

GET 操作不会修改任何资源，因此，如果执行一次或多次，这将产生相同结果。

参数	类型	说明
ownerId	字符串	正在访问其资源的用户的标识符。必须与经过身份验证的用户匹配。可能的值为“me”、xuid({xuid}) 或 gt({gamertag})。
targetid	字符串	正在从所有者的用户列表中检索其数据的用户的标识符，Xbox 用户 ID (XUID) 或玩家代号。示例值：xuid(2603643534573581)、gt(SomeGamertag)。

类型	必需	说明	缺少时的响应
XUID	是	调用方具有用户的 Xbox 用户 ID (XUID)。	401 未授权

标头	说明
授权	字符串。 Xbox LIVE 的授权数据。这通常是加密的 XSTS 令牌。示例值：XBL3.0 x=<userhash>;<token>。

标头	说明
X-RequestedServiceVersion	此请求应定向到的 Xbox LIVE 服务的版本名称/版本号。在验证标头的有效性、身份验证令牌中的声明等信息之后，请求将仅路由到该服务。默认值：1。
Accept	字符串。调用方在响应中接受的 Content-Type。所有响应均为 application/json。

对象不会在此请求的正文中发送。

服务返回此部分中的状态代码之一，以响应使用此方法对此资源发出的请求。对于用于 Xbox Live 服务的标准 HTTP 状态代码的完整列表，请参阅标准 HTTP 状态代码。

标头	类型	说明
Content-Length	32 位无符号整数	响应正文的长度（以字节为单位）。示例值：22。
Content-Type	字符串	响应正文的 MIME 类型。将始终是 application/json。

如果调用成功，服务将返回目标人员。请参阅 Person (JSON)。

{
    "xuid": "2603643534573581",
    "isFavorite": false,
    "isFollowingCaller": false,
    "socialNetworks": ["LegacyXboxLive"]
}