GET (/users/{ownerId}/people/mute)
获取用户的静音列表。
备注
如果给定了目标，则此 URI 只返回该用户（如果该用户在静音列表中），或者为空（如果该用户不在静音列表中）。
URI 参数
| 参数 | 类型 | 说明 |
|---|---|---|
| ownerId | 字符串 | 必需。 正在访问其资源的用户的标识符。 可能的值为“me”、xuid({xuid}) 或 gt({gamertag})。 必须是经过身份验证的用户。 示例值：xuid(2603643534573581)、gt(SomeGamertag)。 最大大小：无。 |
隐私设置对资源的影响
无。
授权
| 已使用授权声明 | 声明 | 类型 | 必填？ | 示例值 |
|---|---|---|---|---|
| Xuid | 64 位有符号整数 | 是 | 1234567890 |
必需请求标头
| 标头 | 类型 | 说明 |
|---|---|---|
| 授权 | 字符串 | HTTP 身份验证的身份验证凭据。 示例值：Xauth=<authtoken>。 最大大小：无。 |
| X-RequestedServiceVersion | 字符串 | 此请求应定向到的 Xbox LIVE 服务的版本名称/版本号。 在验证标头的有效性、授权令牌中的声明等信息之后，请求将仅路由到该服务。 示例值：1、vnext。 最大大小：无。 |
| Accept | 字符串 | 可接受的 Content-Type。 示例值：application/json。 最大大小：无。 |
请求正文
对象不会在此请求的正文中发送。
HTTP 状态代码
服务返回此部分中的状态代码之一，以响应使用此方法对此资源发出的请求。 对于用于 Xbox Live 服务的标准 HTTP 状态代码的完整列表，请参阅标准 HTTP 状态代码。
| 代码 | 原因短语 | 说明 |
|---|---|---|
| 200 | OK | 成功请求静音列表。 |
| 400 | 无效的请求 | URI 中指定的目标 ID 无效。 |
| 403 | 已禁止 | URI 中指定的所有者不是经过身份验证的用户。 |
| 404 | 未找到 | URI 中指定的所有者不存在。 |
必需响应标头
| 标头 | 类型 | 说明 |
|---|---|---|
| Content-Type | 字符串 | 请求正文的 MIME 类型。 示例值: application/json |
| Content-Length | 字符串 | 在响应中发送的字节数。 示例值：34 |
| Cache-Control | 字符串 | 来自服务器的指定缓存行为的礼貌请求。 示例：no-cache, no-store |
响应正文
示例响应
请参阅 UserList。
{
"users":
[
{ "xuid":"12345" },
{ "xuid":"23456" }
]
}