创建音视频房间。

创建房间后，房间默认为初始化状态，第一位成员进入房间时，房间转为正常运行状态。

服务端创建房间后 24 小时内，如果无人加入房间，房间会自动销毁。

URL

• 请求方法：POST
• URL：https://logic-dev.netease.im/v2/api/room

接口请求频率

默认上限为 50 次/秒，若请求频率超出限制，可能会返回 429 错误码。
若您需要上调上限，请参考如何处理调用服务端 RESTful API 超出频率限制。

请求参数

参数名称	类型	是否必选	示例	描述
channelName	String	必选	abc	房间名称。
mode	Int	必选	2	固定为 2。
uid	int64	必选	163	房间创建者的用户 ID，是您的业务系统中的实际用户 ID。 长度限制为二级制 64 位。

返回参数

参数名称	类型	示例	描述
code	int	200	状态码。
cid	int64	12345	房间 ID。

示例

请求示例

{
    "channelName": "abc",  
    "mode": 2,               
    "uid": 163,               
}

正常返回示例

{ 
    "code": 200,  
    "cid": 12345   
}

错误码

• header 中的状态码：

  状态码列表请参考 header 中的 HTTP 状态码。

• body 中的错误码（code）

  该接口在 HTTP Body 中返回错误码（code），错误码列表请参考业务错误码。