> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/{ownerId}/people/mute)

> GET (/users/{ownerId}/people/mute)

# GET (/users/{ownerId}/people/mute)

获取用户的静音列表。

* [备注](#ID4EQ)
* [URI 参数](#ID4EZ)
* [隐私设置对资源的影响](#ID4EEB)
* [授权](#ID4ENB)
* [必需的请求标头](#ID4ESC)
* [请求正文](#ID4EPE)
* [HTTP 状态代码](#ID4E1E)
* [必需的响应标头](#ID4E3G)
* [响应正文](#ID4ETAAC)

## 备注

如果指定了目标,则仅当该用户在静音列表中时,此 URI 才返回该用户;否则若该用户不在列表中则返回空。

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| ownerId | string | 必需。正在访问其资源的用户的标识符。可能的值为 "me"、`xuid()` 或 gt({gamertag})。必须为经过身份验证的用户。示例值:`xuid(2603643534573581)`、`gt(SomeGamertag)`。最大大小:无。 |

## 隐私设置对资源的影响

无。

## 授权

使用的授权声明 | 声明 | 类型 | 是否必需? | 示例值 |
\| --- | --- | --- | --- | --- | --- | --- |
\| Xuid | 64 位有符号整数 | 是 | 1234567890 |

## 必需的请求标头

\| 标头 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization | string | HTTP 身份验证的身份验证凭据。示例值:`Xauth=<authtoken>`。最大大小:无。 |
\| X-RequestedServiceVersion | string | 此请求应指向的 XBOX LIVE 服务的生成名称/编号。仅在验证标头的有效性、授权令牌中的声明等的有效性之后,请求才会路由到该服务。示例值:`1`、`vnext`。最大大小:无。 |
\| Accept | string | 可接受的 Content-Type。示例值:`application/json`。最大大小:无。 |

## 请求正文

此请求正文中未发送任何对象。

## HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的一个状态代码。有关 XBOX Live 服务使用的标准 HTTP 状态代码的完整列表,请参阅[标准 HTTP 状态代码](/zh-CN/reference/live/rest/additional/httpstatuscodes)。

\| 代码 | 原因短语 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200 | OK | 请求静音列表成功。 |
\| 400 | Bad Request | URI 中指定的目标 ID 无效。 |
\| 403 | Forbidden | URI 中指定的所有者不是经过身份验证的用户。 |
\| 404 | Not Found | URI 中指定的所有者不存在。 |

## 必需的响应标头

\| 标头 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Type | string | 请求正文的 MIME 类型。示例值:`application/json` |
\| Content-Length | string | 响应中发送的字节数。示例值:34 |
\| Cache-Control | string | 服务器发出的用于指定缓存行为的礼貌请求。示例:`no-cache, no-store` |

## 响应正文

### 示例响应

请参阅 [UserList](/zh-CN/reference/live/rest/json/json-userlist)。

```cpp theme={null}
{
    "users":
    [
        { "xuid":"12345" },
        { "xuid":"23456" }
    ]
}

```

## 另请参阅

##### 父主题

[/users/{ownerId}/people/mute](/zh-CN/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemute)


## Related topics

- [Privacy and permissions overview](/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Vue d'ensemble de la confidentialité et des autorisations](/fr/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Visão geral de privacidade e permissões](/pt-BR/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Información general sobre privacidad y permisos](/es/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
