创建房间

更新时间: 2023/07/13 02:47:56

创建音视频房间。

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

服务端创建房间后 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   
}

错误码

此文档是否对你有帮助?
有帮助
去反馈
  • URL
  • 接口请求频率
  • 请求参数
  • 返回参数
  • 示例
  • 请求示例
  • 正常返回示例
  • 错误码