API 概览
更新时间: 2024/07/12 17:27:46
网易云信 NERoom 房间组件(下文简称 NERoom) 以房间为基础,提供网易云信全系列能力,包括即时消息、音视频通话、直播、互动白板等。提供易接入、强扩展、高效部署和覆盖多场景的服务。通过组件与 UI kit,助力企业快速搭建业务场景,例如多人语聊房、秀场直播、电商直播、在线教育、企业培训、活动直播等多种场景。
概述
NERoom 基于网易云信在 IM 即时消息、音视频通话等领域多年的客户积累与业务沉淀,为您提供高效、低成本的能力接入。
NERoom 提供典型业务场景的模板,让房间灵活可变形。场景模板包括多人语聊房、秀场直播、电商直播、在线教育、企业培训、活动直播等。
NERoom 提供即时消息、音视频通话、互动白板、麦位管理、角色管理等模块,开发者可根据模块按需选择业务能力,实现积木式的功能组装。通过可视化界面配置,快速开通相关能力,降低集成难度、提升接入效率。
NERoom 还开放各类标准接口和扩展能力,开发者可基于标准接口对接第三方厂商或自有业务系统,扩展自有业务所需功能,真正实现业务的全面发展。
API 列表
本文介绍 NERoom SDK 的 Restful API 列表。
账号管理
API | 方法 | 请求URL |
---|---|---|
创建账号 | POST | https://{endpoint}/neroom/v3/users |
更新账号和 Token | PATCH | https://{endpoint}/neroom/v3/users/:user_uuid |
获取账号信息 | GET | https://{endpoint}/neroom/v3/users/:user_uuid |
批量获取账户信息 | GET | https://{endpoint}/neroom/v3/users?user_uuids=:user_uuids |
房间管理
API | 方法 | 请求URL |
---|---|---|
创建房间 | POST | https://{endpoint}/neroom/v3/rooms |
关闭房间 | DELETE | https://{endpoint}/neroom/v3/rooms/:room_archive_id |
房间禁言 | PATCH | https://{endpoint}/neroom/v1/rooms/:room_archive_id/mute |
房间解禁 | PATCH | https://{endpoint}/neroom/v1/rooms/:room_archive_id/cancel_mute |
获取禁言房间列表 | GET | https://{endpoint}/neroom/v1/rooms/:room_archive_id/mute_list |
添加黑名单 | PATCH | https://{endpoint}/neroom/v1/rooms/{room_archive_id}/add_blacklist |
移除黑名单 | PATCH | https://{endpoint}/neroom/v1/rooms/:room_archive_id/remove_blacklist |
获取黑名单 | GET | https://{endpoint}/neroom/v1/rooms/:room_archive_id/blacklist |
房间成员管理
API | 方法 | 请求URL |
---|---|---|
查询在线人员列表 | GET | https://{endpoint}/v3/rooms/:room_archive_id/online_user_list?page_number=:page_number&page_size=:page_size |
变更成员角色 | PATCH | https://{endpoint}/neroom/v3/rooms/:room_archive_id/users/:user_uuid/role |
移出房间成员 | DELETE | https://{endpoint}/neroom/v3/rooms/:room_archive_id/users/:user_uuid |
成员禁言 | PATCH | https://{endpoint}/neroom/v1/rooms/:room_archive_id/users/:user_uuid/mute |
成员解禁 | PATCH | PATCH https://{endpoint}/neroom/v1/rooms/:room_archive_id/users/:user_uuid/cancel_mute |
即时消息
API | 方法 | 请求URL |
---|---|---|
发送聊天室自定义消息 | POST | https://{endpoint}/neroom/v3/rooms/:room_archive_id/messages |
发送全服广播消息 | POST | https://{endpoint}/neroom/v1/broadcast |
发送自定义房间信令 | POST | https://{endpoint}/neroom/v3/rooms/:room_archive_id/custom_messages |
麦位
API | 方法 | 请求URL |
---|---|---|
获取麦位信息 | GET | https://{endpoint}/neroom/v3/rooms/:room_archive_id/seats/slot_list |
数据统计
API | 方法 | 请求URL |
---|---|---|
查询房间录制记录 | GET | https://{endpoint}/neroom/v3/rooms/:room_archive_id/media_info |
查询房间直播流名称 | GET | https://{endpoint}/neroom/v3/rooms/:room_archive_id/live_stream_name |
此文档是否对你有帮助?