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
此文档是否对你有帮助?
有帮助
去反馈
  • 概述
  • API 列表
  • 账号管理
  • 房间管理
  • 房间成员管理
  • 即时消息
  • 麦位
  • 数据统计