全局禁言

更新时间：2021-12-31 该文档已不再维护，请看新版 3.X 文档。

新版文档地址：用户全局禁言

全局禁言：包括单聊消息全局禁言、群组消息全局禁言和聊天室全局禁言。

• 帐号默认未设置单聊消息全局禁言。如果帐号被设置单聊消息全局禁言，在单聊消息禁言时间未到期时间内所有的单聊消息发送失败，到期后IM后台自动解除单聊消息禁言，解除后所有单聊消息就能发送正常；对于永久全局单聊禁言，全局单聊消息禁言时间一直不过期。
• 帐号默认未设置群组消息全局禁言。如果帐号被设置群组消息全局禁言，在群组消息禁言时间未到期时间内所有的群组消息发送失败，到期后IM后台自动解除群组消息禁言，解除后所有群组消息就能发送正常；对于永久全局群组禁言，全局群组消息禁言时间一直不过期。
• 帐号默认未设置聊天室消息全局禁言。如果帐号被设置聊天室消息全局禁言，在聊天室消息禁言时间未到期时间内所有的聊天室消息发送失败，到期后IM后台自动解除聊天室消息禁言，解除后所有聊天室消息就能发送正常；对于永久全局聊天室禁言，全局聊天室消息禁言时间一直不过期。

注：全局禁言期间，该帐户包含 SDK 端和服务器端调接口发消息都是会发送失败

随着监管机制对应用监管的逐渐加强，安全合规成了应用的生命线。环信 IM 提供全局禁言功能，帮助应用实现用户账号级别的禁言管理功能，在发现违规用户后，可通过该功能对需要禁言的用户进行全局禁言操作，维护应用内良好的内容生态环境。

• 发现某用户，频繁往多个聊天室发送违规广告，对该用户全局聊天室禁言 15 天；
• 发现某用户，发表触犯红线的政治言论，先全局永久禁言，等用户申诉通过再解禁；

• 支持设置帐号的单聊、群聊、聊天室消息全局禁言；
• 支持查询（单个）帐号的单聊、群聊、聊天室消息全局禁言；
• 支持查询 App Key 下所有账号的单聊、群聊、聊天室消息全局禁言。

设置单个帐号的单聊、群组、聊天室消息全局禁言。

请求方法：POST

接入点： /{orgName}/{appName}/mutes

curl -L -X POST 'https://a1.easemob.com/easemob-demo/testappkey/mutes' \
-H 'Authorization: Bearer {{token}}' \
-H 'Content-Type: application/json' \
--data-raw '{
    "username": "zs1",
    "chat": 100,
    "groupchat": 100,
    "chatroom": 100
}'

{
    "path": "/mutes",
    "uri": "https://a1.easemob.com/easemob-demo/testappkey/mutes",
    "timestamp": 1631609754727,
    "organization": "easemob-demo",
    "application": "357169f0-492a-11e9-9b3a-f1af649cc48d",
    "action": "post",
    "data": {
        "result": "ok"
    },
    "duration": 74,
    "applicationName": "testappkey"
}

查询单个用户的单聊/群聊/聊天室消息禁言

方法：GET

接入点： /{orgName}/{appName}/mutes/username

curl -L -X GET 'https://a1.easemob.com/easemob-demo/testappkey/mutes/zs1' \
-H 'Authorization: Bearer {{token}}' \
-H 'Content-Type: application/json'

{
    "path": "/mutes",
    "uri": "https://a1.easemob.com/easemob-demo/testappkey/mutes",
    "timestamp": 1631609831800,
    "organization": "easemob-demo",
    "application": "357169f0-492a-11e9-9b3a-f1af649cc48d",
    "action": "get",
    "data": {
        "userid": "easemob-demo#restys_zs1",
        "chat": 96,
        "groupchat": 96,
        "chatroom": 96,
        "unixtime": 1631609831
    },
    "duration": 13,
    "applicationName": "testappkey"
}

查询 App Key下的用户禁言剩余时间的集合。

方法：GET

接入点： /{orgName}/{appName}/mutes

### 请求头

curl -L -X GET 'https://a1.easemob.com/easemob-demo/testappkey/mutes?pageNum=1&pageSize=10' \
-H 'Authorization: Bearer {{token}}' \
-H 'Content-Type: application/json'

{
    "path": "/mutes",
    "uri": "https://a1.easemob.com/easemob-demo/testappkey/mutes",
    "timestamp": 1631609858771,
    "organization": "easemob-demo",
    "application": "357169f0-492a-11e9-9b3a-f1af649cc48d",
    "action": "get",
    "data": {
        "data": [
            {
                "username": "zs2",
                "chatroom": 0
            },
            {
                "username": "zs1",
                "groupchat": 69
            },
            {
                "username": "zs1",
                "chat": 69
            },
            {
                "username": "zs1",
                "chatroom": 69
            },
            {
                "username": "h2",
                "chatroom": 0
            },
            {
                "username": "h2",
                "groupchat": 0
            },
            {
                "username": "h2",
                "chat": 0
            }
        ],
        "unixtime": 1631609858
    },
    "duration": 17,
    "applicationName": "testappkey"
}