网易云信 IM 服务端支持更新已创建的聊天室的信息，包括聊天室名称、公告、直播地址、扩展字段、事件通知扩展字段、聊天室队列管理权限、反垃圾配置等。

URL

httpPOST https://api.netease.im/nimserver/chatroom/update.action HTTP/1.1
Content-Type:application/x-www-form-urlencoded;charset=utf-8

请求参数

• POST 请求中 Headers 的设置请参考API调用方式。

• POST 请求中 Body 的设置如下：

参数	类型	必须	说明
roomid	long	是	聊天室id
name	String	否	聊天室名称，长度限制128个字符
announcement	String	否	公告，长度限制4096个字符
broadcasturl	String	否	直播地址，长度限制1024个字符
ext	String	否	扩展字段，长度限制4096个字符
needNotify	String	否	true或false,是否需要发送更新通知事件，默认true
notifyExt	String	否	通知事件扩展字段，长度限制2048
queuelevel	int	否	队列管理权限：0:所有人都有权限变更队列，1:只有主播管理员才能操作变更
bid	String	否	反垃圾业务ID，JSON字符串，{"textbid":"","picbid":""}，若不填则使用原来的反垃圾配置

示例

cURL请求示例

curlcurl -X POST -H "CheckSum: 95a26060**cb7d949d6e91d6d167" -H "AppKey: f1234540c1**56847aaaaaa" -H "Nonce: 1" -H "CurTime: 1451214690" -H "Content-Type: application/x-www-form-urlencoded" -d 'roomid=66&name=mynewchatroom&announcement=mynewchatroom' 'https://api.netease.im/nimserver/chatroom/update.action'

返回示例

请求成功的返回示例如下:

json"Content-Type": "application/json; charset=utf-8"
{
  "chatroom": {
    "roomid": 66,
    "valid": true,
    "announcement": "这是聊天室",
    "name": "mychatroom",
    "broadcasturl": "xxxxxx",
    "ext": "",
    "creator": "zhangsan"
  },
  "code": 200
}

状态码

该 API 在 HTTPS Body 中返回请求的状态码，状态码详情请参见状态码。