====== 聊天室管理 ======

----

环信提供了 REST API 来管理 APP 中的聊天室。

单个APP创建聊天室数量有[[http://www.easemob.com/pricing/im|限制]]，如需增加可根据具体业务联系商务解决。单用户ID只能加入500个聊天室。

===== 聊天室数据结构 =====

^名称	^类型	^描述^
|id	|String	|聊天室 ID，聊天室唯一标识符，由环信服务器生成。|
|name	|String	|聊天室名称，任意字符串。|
|description	|String	|聊天室描述，任意字符串。|
|maxusers	|Integer|聊天室成员上限，创建聊天室的时候设置，可修改。|
|affiliations_count	|Integer|现有成员总数。|
|affiliations	|Array	|现有成员列表，包含了 owner 和 member。例如： “affiliations”:[{“owner”: “13800138001”},{“member”:”v3y0kf9arx”},{“member”:”xc6xrnbzci”}]。|
|owner	|String	|聊天室创建者的 username。例如：{“owner”: “13800138001”}。|
|member	|String	|聊天室成员的 username。例如： {“member”:”xc6xrnbzci”}。|

===== 聊天室角色 =====

除了聊天室创建者（owner）、普通聊天室成员之外，新增聊天室管理员角色。

聊天室角色权限范围：创建者 > 聊天室管理员 > 普通聊天室成员

  * 聊天室创建者拥有聊天室所有权限；
  * 聊天室管理员拥有添加/移除黑名单、添加/移除禁言等权限。

===== 管理聊天室 =====

==== 获取 APP 中所有的聊天室 ====

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms
  * HTTP Method: GET
  * URL Params: pagenum 查询指定的页码，从1开始，数字类型; pagesize 查询指定每页显示的记录数，数字类型。__该接口会返回：按照“分页获取APP下的聊天室” 接口中，pagenum=1, pagesize=20 的查询结果。如需获取更多聊天室列表，建议使用分页接口。__
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的JSON数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php> 
curl -X GET -H "Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw4523fWqIrXI8" -i  "https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms?pagenum=2&pagesize=3"
</code>

Response 示例：

<code json> 
{
  "action": "get",
  "params": {
    "pagesize": [
      "3"
    ],
    "pagenum": [
      "2"
    ]
  },
  "uri": "http://a1.easemob.com/easemob-demo/chatdemoui/chatrooms",
  "entities": [],
  "data": [
    {
      "id": "124375842267595332",
      "name": "testchatroom",
      "owner": "zp300",
      "affiliations_count": 631
    },
    {
      "id": "124375913398796852",
      "name": "azpp",
      "owner": "zp300",
      "affiliations_count": 532
    },
    {
      "id": "132598658687304132",
      "name": "123456",
      "owner": "55",
      "affiliations_count": 435
    }
  ],
  "timestamp": 1477543557486,
  "duration": 21,
  "count": 3
}
</code>

==== 获取用户加入的聊天室 ====

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/users/{username}/joined_chatrooms
  * HTTP Method: GET
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的JSON数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X GET 'https://a1.easemob.com/easemob-demo/chatdemoui/users/jma1/joined_chatrooms' -H 'Authorization: Bearer YWMtgNIiTFAwEeSB9olyTIXFtwAAAUotKvWaUOaUuqeuhNMgOgozO4popVZe-Ls'
</code>

Response 示例：

<code json>
{
  "action" : "get",
  "uri" : "https://a1.easemob.com/easemob-demo/chatdemoui/users/jma1/joined_chatrooms",
  "entities" : [ ],
  "data" : [ {
    "id" : "1432266600611977",
    "name" : "testchatroom"
  } ],
  "timestamp" : 1432268305229,
  "duration" : 23
}
</code>

==== 获取聊天室详情 ====

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}
  * HTTP Method: GET
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的JSON数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：404（此聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X GET -H "Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw45TXUWSIrXI8"  -i  "https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1432259621444159"
</code>

Response 示例：

<code json>
{
  "action" : "get",
  "uri" : "https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1432259621444159",
  "entities" : [ ],
  "data" : [ {
    "membersonly" : false,
    "allowinvites" : false,
    "public" : true,
    "name" : "hxt001room0516",
    "description" : "chatroom description",
    "affiliations" : [ {
      "owner" : "hxt001"
    } ],
    "id" : "1432259621444159",
    "maxusers" : 2000,
    "affiliations_count" : 1
  } ],
  "timestamp" : 1432267287589,
  "duration" : 1
}
</code>

==== 创建一个聊天室 ====

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms
  * HTTP Method: POST
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body:

<code json>
{
    "name":"testchatroom", //聊天室名称，此属性为必须的
    "description":"server create chatroom", //聊天室描述，此属性为必须的
    "maxusers":300, //聊天室成员最大数（包括聊天室创建者owner），值为数值类型，默认值200，最大值5000，此属性为可选的
    "owner":"jma1", //聊天室创建者，此属性为必须的
    "members":["jma2","jma3"] //聊天室成员，此属性为可选的，但是如果加了此项，数组元素至少一个（注：聊天室创建者jma1不需要写入到members里面）
}
</code>

  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X POST 'https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms' -H 'Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LEUE' -d '{"name":"testchatroom","description":"server create chatroom","owner":"jma1","maxusers":300,"members":["ceshia"]}'
</code>

Response 示例：

<code json> 
{
    "action": "post",
    "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5",
    "uri": "https://a1.easemob.com/easemob-demo/chatdemoui",
    "entities": [],
    "data": {
        "id": "1432289956668375"
    },
    "timestamp": 1432289956589,
    "duration": 85,
    "organization": "easemob-demo",
    "applicationName": "chatdemoui"
}
</code>

==== 修改聊天室信息 ====

修改成功的数据行会返回 true，失败为 false。请求 body 只接收 name、description、maxusers 三个属性。传其他字段，或者不能修改的字段会抛异常。

如果要修改的聊天室不存在，将返回错误。

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}
  * HTTP Method: PUT
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 

<code json> 
{
    "name":"test chatroom", //聊天室名称，修改时值不能包含斜杠("/")。 
    "description":"update chatroom info", //聊天室描述，修改时值不能包含斜杠("/")。
    "maxusers":200, //聊天室成员最大数（包括聊天室创建者），值为数值类型
}
</code>

  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：404（此聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X PUT 'https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1432259621444159' -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnC3U4gI0-rQImw4523fWqIrXI8' -d '{"name":"test chatroom","description":"update chatroominfo","maxusers":200}'
</code>

Response 示例：

<code json>
{
  "action" : "put",
  "application" : "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5",
  "uri" : "https://a1.easemob.com/easemob-demo/chatdemoui",
  "entities" : [ ],
  "data": {
    "description": true,
    "maxusers": true,
    "groupname": true
  },
  "timestamp" : 1432269159287,
  "duration" : 14,
  "organization" : "easemob-demo",
  "applicationName" : "chatdemoui"
}
</code>

==== 删除聊天室 ====

删除单个聊天室。如果要删除的聊天室不存在，将返回错误。

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}
  * HTTP Method: DELETE
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：404（聊天室不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X DELETE 'https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1432259621444159' -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnaf3sqrQFnCU4gI0-rQImw45TXUWSIrXI8'
</code>

Response 示例：

<code json>
{
    "action": "delete",
    "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5",
    "uri": "https://a1.easemob.com/easemob-demo/chatdemoui",
    "entities": [],
    "data": {
        "success": true,
        "id": "1432289956668375"
    },
    "timestamp": 1432290072350,
    "duration": 146,
    "organization": "easemob-demo",
    "applicationName": "chatdemoui"
}
</code>

===== 管理聊天室成员 =====

==== 分页获取聊天室成员 ====

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}/users
  * HTTP Method: GET
  * URL Params: pagenum： 页码，从1开始；pagesize: 每页显示数量,最大不超过1000
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：400（用户不存在）、404（聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：服务器端 REST API 常见错误码

curl 示例；

<code>
curl -XGET HTTP://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/users?pagenum=2&pagesize=2 -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw4523fWqIasd1'
</code>

Response示例：

<code json>
	 {
	  "action": "get",
	  "application": "527cd7e0-04b3-11e7-9f59-ef10ecd81ff0",
	  "params": {
	    "pagesize": [
	      "2"
	    ],
	    "pagenum": [
	      "2"
	    ]
	  },
	  "uri": "http://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/users",
	  "entities": [],
	  "data": [
	    {
	      "member": "user1"
	    },
	    {
	      "member": "user2"
	    }
	  ],
	  "timestamp": 1489074511416,
	  "duration": 0,
	  "organization": "easemob-demo",
	  "applicationName": "chatdemoui",
	  "count": 2
	}
</code>
==== 添加聊天室成员[单个] ====

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms/{chatroomid}/users/{username}
  * HTTP Method: POST
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: result 表示添加结果：true 添加成功，false　添加失败。
  * 可能的错误码：400（IM用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X POST -H "Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LAAA" -i  "https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/96330911796167468/users/jianxin1"
</code>

Response 示例：

<code json>
{
    "action": "post",
    "application": "ca91dcc0-89aa-11e4-8e50-4d99c3a32a95",
    "uri": "https://a1.easemob.com/easemob-demo/chatdemoui",
    "entities": [],
    "data": {
        "result": true,
        "action": "add_member",
        "id": "96330911796167468",
        "user": "jianxin1"
    },
    "timestamp": 1441094788695,
    "duration": 27,
    "organization": "easemob-demo",
    "applicationName": "chatdemoui"
}
</code>

==== 添加聊天室成员[批量] ====

向聊天室添加多位用户，一次性最多可添加60位用户。

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms/{chatroomid}/users
  * HTTP Method: POST
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: {"usernames":["username1", "username2"]}
  * Response Body: 请求成功会返回被加入聊天室中的新成员 username
  * 可能的错误码：400（聊天室id不存在、用户不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X POST -H "Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LAAA" -i  "https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/96330911796167468/users" -d '{"usernames":["jianxin1", "jianxin2"]}'
</code>

Response 示例：

<code json>
{
    "action": "post",
    "application": "ca91dcc0-89aa-11e4-8e50-4d99c3a32a95",
    "uri": "https://a1.easemob.com/easemob-demo/chatdemoui",
    "entities": [],
    "data": {
        "newmembers": [
            "jianxin1",
            "jianxin2"
        ],
        "action": "add_member",
        "id": "96330911796167468"
    },
    "timestamp": 1441095085904,
    "duration": 18,
    "organization": "easemob-demo",
    "applicationName": "chatdemoui"
}
</code>

==== 删除聊天室成员[单个] ====

从聊天室删除一个成员。如果被删除用户不在聊天室中，或者聊天室不存在，将返回错误。

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms/{chatroomid}/users/{username}
  * HTTP Method: DELETE
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: result 表示添加结果：true 添加成功，false 添加失败。
  * 可能的错误码： 400（用户不存在）、404（被删除用户不在聊天室中，或者聊天室不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X DELETE -H "Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LAAA" -i  "https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/96330911796167468/users/jianxin1"
</code>

Response 示例：

<code json>
{
    "action": "delete",
    "application": "ca91dcc0-89aa-11e4-8e50-4d99c3a32a95",
    "uri": "https://a1.easemob.com/easemob-demo/chatdemoui",
    "entities": [],
    "data": {
        "result": true,
        "action": "remove_member",
        "id": "96330911796167468",
        "user": "jianxin1"
    },
    "timestamp": 1441095234884,
    "duration": 13,
    "organization": "easemob-demo",
    "applicationName": "chatdemoui"
}
</code>

==== 删除聊天室成员[批量] ====

从聊天室删除多个成员。如果被删除用户不在聊天室中，或者聊天室不存在，将返回错误。

<WRAP round tip>
注意：在调用程序中，如果返回429或503错误，说明接口被限流了，请稍微暂停一下并重试。详见[[start:450errorcode:45restastrict|接口限流说明]]。
</WRAP>

  * Path: /{org_name}/{app_name}/chatrooms/{chatroomid}/users/{username1},{username2}
  * HTTP Method: DELETE
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: result 表示添加结果：true 添加成功，false　添加失败，添加失败的原因会描述在 reason 字段中。
  * 可能的错误码： 400（用户不存在）、404（被删除用户不在聊天室，或者聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：[[start:450errorcode:10restapierrorcode|服务器端 REST API 常见错误码]]

curl 示例：

<code php>
curl -X DELETE -H "Authorization: Bearer YWMtP_8IisA-EeK-a5cNq4Jt3QAAAT7fI10IbPuKdRxUTjA9CNiZMnQIgk0LAAA" -i  "https://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/96330911796167468/users/jianxin1,jianxin2"
</code>

Response 示例：

<code json>
{
    "action": "delete",
    "application": "ca91dcc0-89aa-11e4-8e50-4d99c3a32a95",
    "uri": "https://a1.easemob.com/easemob-demo/chatdemoui",
    "entities": [],
    "data": [
        {
            "result": true,
            "action": "remove_member",
            "id": "96330911796167468",
            "user": "jianxin1"
        },
        {
            "result": false,
            "action": "remove_member",
            "reason": "user jianxni2 doesn't exist.",
            "id": "96330911796167468",
            "user": "jianxni2"
        }
    ],
    "timestamp": 1441095321332,
    "duration": 21,
    "organization": "easemob-demo",
    "applicationName": "chatdemoui"
}
</code>

==== 获取聊天室管理员列表 ====

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}/admin
  * HTTP Method: GET
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：400（用户不存在）、404（聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：服务器端 REST API 常见错误码

curl示例：

<code>
curl -XGET HTTP://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/admin -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw4523fWqIasd1'
</code>

Response示例：

<code json>
	{
	  "action": "get",
	  "application": "527cd7e0-04b3-11e7-9f59-ef10ecd81ff0",
	  "uri": "http://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/admin",
	  "entities": [],
	  "data": [
	    "z1"
	  ],
	  "timestamp": 1489073361210,
	  "duration": 0,
	  "organization": "easemob-demo",
	  "applicationName": "chatdemoui",
	  "count": 1
	}
</code>

==== 添加聊天室管理员 ====

将一个聊天室成员角色提升为聊天室管理员。

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}/admin
  * HTTP Method: POST
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 参见curl示例
  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：400（用户不存在）、404（聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：服务器端 REST API 常见错误码

curl示例：

<code>
curl -XPOST HTTP://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/admin -d '{"newadmin":"z1"}' -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw4523fWqIasd1'
</code>

Response示例：

<code json>
	{
	  "action": "post",
	  "application": "527cd7e0-04b3-11e7-9f59-ef10ecd81ff0",
	  "uri": "http://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/admin",
	  "entities": [],
	  "data": {
	    "result": "success",
	    "newadmin": "z1"
	  },
	  "timestamp": 1489073130083,
	  "duration": 1,
	  "organization": "easemob-demo",
	  "applicationName": "chatdemoui"
	}
</code>

==== 移除聊天室管理员 ====

将用户的角色从聊天室管理员降为普通聊天室成员。

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}/admin/{oldadmin}
  * HTTP Method: DELETE
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：400（用户不存在）、404（聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：服务器端 REST API 常见错误码

curl示例：

<code>
curl -XDELETE HTTP://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/admin/z1 -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw4523fWqIasd1'
</code>

Response示例：

<code>
	{
	  "action": "delete",
	  "application": "527cd7e0-04b3-11e7-9f59-ef10ecd81ff0",
	  "uri": "http://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/admin/z1",
	  "entities": [],
	  "data": {
	    "result": "success",
	    "oldadmin": "z1"
	  },
	  "timestamp": 1489073432732,
	  "duration": 1,
	  "organization": "easemob-demo",
	  "applicationName": "chatdemoui"
	}
</code>


===== 管理禁言 =====

==== 获取禁言列表 ====

获取当前聊天室的禁言用户列表。

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}/mute
  * HTTP Method: GET
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：400（用户不存在）、404（聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：服务器端 REST API 常见错误码

curl示例：

<code>
curl -XGET HTTP://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/mute -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw4523fWqIasd1'
</code>

Response示例：

<code json>
	{
	  "action": "post",
	  "application": "527cd7e0-04b3-11e7-9f59-ef10ecd81ff0",
	  "uri": "http://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/mute",
	  "entities": [],
	  "data": [
	    {
	      "expire": 1489158589481,
	      "user": "z3"
	    },
	    {
	      "expire": 1489158589481,
	      "user": "z1"
	    },
	    {
	      "expire": 1489158589481,
	      "user": "z2"
	    }
	  ],
	  "timestamp": 1489072802179,
	  "duration": 0,
	  "organization": "easemob-demo",
	  "applicationName": "chatdemoui"
	}
</code>

==== 添加禁言 ====

将一个用户禁言。用户被禁言后，将无法在聊天室中发送消息。

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}/mute
  * HTTP Method: POST
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 参见curl示例
  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：400（用户不存在）、404（聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：服务器端 REST API 常见错误码
 
curl示例：

<code>
curl -XPOST HTTP://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/mute -d '{"usernames":["z1","z2","z3"], "mute_duration":86400000}' -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw4523fWqIasd1'
</code>

其中，usernames后是被禁言的用户ID， mute_duration是禁言的时长，单位是毫秒，必须是Integer或者Long类型。

Response示例:

<code json>
	{
	  "action": "post",
	  "application": "527cd7e0-04b3-11e7-9f59-ef10ecd81ff0",
	  "uri": "http://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/mute",
	  "entities": [],
	  "data": [
	    {
	      "result": true,
	      "expire": 1489158589481,
	      "user": "z1"
	    },
	    {
	      "result": true,
	      "expire": 1489158589481,
	      "user": "z2"
	    },
	    {
	      "result": true,
	      "expire": 1489158589481,
	      "user": "z3"
	    }
	  ],
	  "timestamp": 1489072189508,
	  "duration": 0,
	  "organization": "easemob-demo",
	  "applicationName": "chatdemoui"
	}
</code>

注：expire指的是禁言到期的UNIX时间戳。

==== 移除禁言 ====

将用户从禁言列表中移除。移除后，用户可以正常在聊天室中发送消息。

  * Path: /{org_name}/{app_name}/chatrooms/{chatroom_id}/mute/{member1}(,{member2},...)
  * HTTP Method: DELETE
  * URL Params: 无
  * Request Headers: {“Authorization”:”Bearer ${token}”}
  * Request Body: 无
  * Response Body: 详情参见示例返回值，返回的 JSON 数据中会包含除上述属性之外的一些其他信息，均可以忽略。
  * 可能的错误码：400（用户不存在）、404（聊天室id不存在）、401（未授权[无token、token错误、token过期]）、5xx。详见：服务器端 REST API 常见错误码

curl示例：

<code>
curl -XDELETE HTTP://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/mute/z1,z2,z3  -H 'Authorization: Bearer YWMtG4T5wkOTEeST5V-9lp7f-wAAAUnafsqrQFnCU4gI0-rQImw4523fWqIasd1'
</code>

Response示例:

<code json>
	{
	  "action": "delete",
	  "application": "527cd7e0-04b3-11e7-9f59-ef10ecd81ff0",
	  "uri": "http://a1.easemob.com/easemob-demo/chatdemoui/chatrooms/1265710621211/mute/z1,z2,z3",
	  "entities": [],
	  "data": [
	    {
	      "result": true,
	      "user": "z1"
	    },
	    {
	      "result": true,
	      "user": "z2"
	    },
	    {
	      "result": true,
	      "user": "z3"
	    }
	  ],
	  "timestamp": 1489072695859,
	  "duration": 0,
	  "organization": "easemob-demo",
	  "applicationName": "chatdemoui"
	}
</code>


----
<WRAP group>
<WRAP half column>
上一页：[[start:100serverintegration:60groupmgmt|群组管理]]
</WRAP>

<WRAP half column>
下一页：[[start:100serverintegration:group-and-chatroom-changes|新版群组/聊天室服务 REST API差异说明v2]]
</WRAP>
</WRAP>