本文介绍如何调用服务端接口创建房间。与客户端创建房间的接口相比，使用服务端接口可以方便您在业务系统中保存房间信息、更好地管理和跟踪房间信息。通过使用该服务端接口，可以提高业务效率。

请求

URI

POST https://{endpoint}/neroom/v4/rooms

• {endpoint} 为 NERoom 接入地址的域名，默认为 roomkit.netease.im。如果您的应用主要服务于海外用户，请将域名设置为海外数据中心域名（roomkit-sg.netease.im）。
• Content-Type：application/json

Header

请求 Header 的设置请参见 请求结构。

请求体参数

请求 Body 的设置如下：

参数名称	类型	是否必选	示例	描述
template_id	Long	是	23	模板ID ，模板 ID获取方法请参见如何获取模板 ID。
room_uuid	String	否	NE****10	房间ID，最大长度64个字符，传空值，则随机生成一个房间ID。 支持以下字符类型： 大写英文字母 小写英文字母 数字 特殊字符，支持-_.~
room_name	String	是	Example	房间名，最大长度为 64 个字符。支持以下字符类型： 中文 大写英文字母 小写英文字母 数字 特殊字符
password	String	否	Example123456	房间密码，最大长度为64个字符。支持以下字符类型： 大写英文字母 小写英文字母 数字 特殊字符
host_user_uuid	String	是	user01	房主的userUuid（已注册的userUuid）
type	Integer	否	1	房间类型。 1：普通房间，24小时后会被关闭（默认1） 2：永久房间，不会主动关闭，需要用户自己关闭
room_name	String	是	Example	房间名，最大长度为 64 个字符。支持以下字符类型： 中文 大写英文字母 小写英文字母 数字 特殊字符
room_profile	Integer	否	0	设置房间场景模式，如果不填，则默认为通信模式。 COMMUNICATION（0）：通信模式。 在语音通话场景下，例如语聊房、K歌房等建议您选择通信模式。 LIVE_BROADCASTING（1）：直播模式。 在互动直播场景下，观众人数比较多，可以直接拉CDN流进行播放，建议您选择直播模式。
+ config	Object	否	-	配置待创建的 NERoom 房间开启哪些功能，不配置则使用模版中的配置
whiteboard	Boolean	可选	true	设置该房间是否包含白板功能。 true（默认）：是。 false：否。
chatroom	Boolean	可选	true	设置该房间是否包含聊天室功能。 true（默认）：是。 false：否。
rtc	Boolean	可选	true	设置该房间是否包含音视频功能。 true（默认）：是。 false：否。
sip	Boolean	可选	true	设置该房间是否开启 sip。 true：是。 false（默认）：否。
record	Boolean	可选	true	设置该房间是否开启录制。 true：是。 false（默认）：否。
+ live	Object	可选	-	该房间直播组件配置，不配置则根据模版配置来决定是开启还是关闭
enable	Boolean	必选	true	设置该房间是否包含直播功能。 true：是。 false（默认）：否。
push_url	String	可选	rtmp://sample.live.net/live/b54***	推流地址。最大长度支持 512 字节。
pull_hls_url	String	可选，但必须至少选择其中一种拉流地址	http://sample.live.net/live/34a***/playlist.m3u8	hls 拉流地址。最大长度支持 512 字节。
pull_rtmp_url	String		rtmp://sample.live.net/live/451***	rtmp 拉流地址。最大长度支持 512 字节。
pull_http_url	String		http://sample.live.net/live/b5r***.flv?sample.live.net	http 拉流地址。最大长度支持 512 字节。
pull_rts_url	String		rtmp://sample.live.net/live/a27***	rts 拉流地址。最大长度支持 512 字节。
+ seat	Object	可选	-	设置是否开启麦位管理，不配置则根据模版配置来决定是开启还是关闭
enable	Boolean	必选	true	设置该房间是否使用麦位组件。 true：是。 false（默认）：否。
seat_count	Integer	是	8	麦位的数量。默认为 8。最多20个麦位。
apply_mode	Integer	否	0	麦位申请审批模式。 0（默认值）：观众申请上麦时，管理员自动同意上麦。 1：观众申请上麦时，需要管理员同意后才能上麦。
invite_mode	Integer	否	0	麦位邀请确认模式。 0（默认值）：管理员邀请观众上麦时，观众自动同意上麦。 1：管理员邀请观众上麦时，需要观众同意后才会上麦。

请求体示例

java
{
    "template_id": 40,
    "room_uuid": "8978634332",
    "room_name": "Example",
    "host_user_uuid":"user01",
    "type":2,
    "room_profile":1,
    "password": "Example123456",
    "config":
    {
        "whiteboard": true,
        "chatroom": true,
        "rtc": true,
        "sip": true,
        "record": true,
        "live":
        {
            "enable": true,
            "push_url": "***",
            "pull_hls_url": "***",
            "pull_rtmp_url": "**",
            "pull_http_url": "***",
            "pull_rts_url": "***"
        },
        "seat":
        {
            "enable": true,
            "seat_count": 8,
            "apply_mode": 1,
            "invite_mode": 0
        }
    }
}

响应

响应参数

参数名称	类型	示例	描述
code	int	0	状态码，0表示成功，具体请参见错误码。
msg	String	Success	业务结果描述，Success表示成功。
ts	Long	1648021056815	NERoom 服务器处理该请求的完成时间。该时间为 Unix 时间戳，即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。
request_id	String	7c4b6d9c3e9d42*****cc6e3a4d995	请求的唯一标识。
cost	String	48ms	处理该请求所消耗的时间。
+ data	Object	-	创建房间的结果
room_archive_id	String	4***251	归档到历史记录中的房间 ID，全局唯一，最大长度36个字符

响应体示例

java{
    "code":0,
    "msg":"Success",
    "ts":1619068087795,
    "request_id":"6e507107d1f4447ea731f651dc6d2432",
    "cost":"66ms",
    "data":{
        "room_archive_id":"136584"
    }
}

错误码

错误码	错误信息	说明	处理建议
0	Success	请求成功	无需处理
400	Invalid parameter.	参数错误	检查接口传参
409	Target already exists.	房间号已经存在	更换room_uuid
1005	Config does not exist.	模版不存在	检查模版id

相关接口

接口	描述
关闭房间	关闭房间