## 聊天室全局禁言模块

禁止用户在应用内所有聊天室中发言，可将此用户添加到聊天室全局禁言中，被禁言用户可以接收聊天室中聊天信息，但不能发送消息

多次调用，以最后一次为准

此功能需开通 [专有云服务](http://www.rongcloud.cn/deployment#proprietary-cloud)

### Ban.add(chatroom){#add}

添加聊天室全局禁言

`chatroom` 参数的**属性说明**：

| 参数   	 |	类型		| 必填	| 说明 							|最低版本		|
| :----------|:--------	|:-----	|:------------------------------|:-------- |
|	members  |	array	|	是 	| 成员列表，最多不超过 20 个		|3.0.0		|
|	minute 	 |	number	|	是 	| 禁言时长，范围: 1 - 1 \* 30 \* 24 \* 60 分钟	| 3.0.0|

`members` 说明:

| 参数   	 |	类型		| 说明 							|最低版本		|
| :----------|:--------	|:------------------------------|:-------- |
|	id 		 |	string	| 添加禁言用户 Id。					| 3.0.0 |

##### 请求成功

```json
{
    "code": 200
}
```

### Ban.remove(chatroom){#remove}

解除聊天室全局禁言

`chatroom` 参数的**属性说明**：

| 参数   	 |	类型		| 必填	| 说明 							|最低版本		|
| :----------|:--------	|:-----	|:------------------------------|:-------- |
|	members  |	array	|	是 	| 解除禁言列表 					| 3.0.0 |

`members` 说明:

| 参数   	 |	类型		| 说明 							|最低版本		|
| :----------|:--------	|:------------------------------|:-------- |
|	id 		 |	string	| 解除禁言用户 Id。					| 3.0.0 |

##### 请求成功

```json
{
    "code": 200
}
```
### Ban.getList(){#getList}

获取聊天室全局禁言列表

##### 请求成功

```json
{
	"code": 200,
	"members": [{
		"id": "2582",
		"time": "2015-09-25 16:12:38"
	}]
}
```
| 参数   	 |	类型		| 说明 							
| :----------|:--------	|:------------------------------
|	id 		 |	string	| 被禁言用户 Id。						
|	time	 |	string	| 解禁时间