黑盒语音机器人帮助文档
  1. 房间接口
黑盒语音机器人帮助文档
  • 教程
  • 开发者服务协议
  • 使用交流
  • 更新日志
  • 开发计划
  • 资源
    • 请求速率限制
    • Websocket
    • Bot命令
  • WEBSOCKET 连接请求
    • 连接到黑盒语音服务
  • HTTP接口
    • 消息接口
      • 发送消息接口的参数
      • 发送消息接口的返回值
      • 发送图片形式的频道消息
      • 发送Markdown文档
      • 更新指定频道消息
      • 删除指定的频道消息
      • 对某条频道消息增加/取消回应(小表情)
      • 发送卡片消息
      • 给用户发送私聊消息
      • 发送频道图片消息
      • 发送频道消息
      • 发送卡片消息
      • 发送频道消息@全体成员/@在线成员
      • 更新指定的频道消息
      • 删除指定的频道消息
      • 对某条频道消息增加/取消回应(小表情)
      • 给用户发送私聊消息
    • 媒体文件上传
      • 上传媒体文件的参数解析
      • 上传媒体文件
    • 房间角色接口
      • 权限相关说明
      • 接口说明
      • 获取房间角色列表
      • 创建角色
      • 更新角色
      • 删除角色
      • 对指定用户授予指定权限
      • 对指定用户剥夺指定权限
    • 房间表情
      • 房间表情包
      • 获取房间上传的表情包
      • 房间删除表情包
      • 房间更新表情包名称
    • 房间接口
      • 房间相关接口文档
      • 修改房间内昵称
        POST
      • 分页获取加入的房间列表
        GET
      • 获取房间信息
        GET
      • 退出房间
        POST
      • 房间踢人
        POST
      • 获取房间用户列表
        POST
      • 语音频道之间移动用户
        POST
      • 踢出语音频道中的用户
        POST
      • 禁言/解禁用户
        POST
      • 频道内麦克风静音/解禁
        POST
      • 房间内麦克风静音/解禁
        POST
      • 房间内扬声器静音/解禁
        POST
      • 获取用户所在频道
        GET
      • 创建频道邀请链接
        GET
      • 频道设置修改
        POST
      • 频道名编辑
        POST
      • 设置频道密码
        POST
      • 修改权限组或成员权限
        POST
    • 在线媒体流
      • 在线媒体流说明文档
      • 推流至语音频道
      • 停止推流至语音频道
  • 服务端推送事件
    • 事件说明
    • 通用推送字段
    • 机器人命令
      • 用户使用Bot命令
    • 频道消息事件
      • 频道消息事件
    • 房间消息事件
      • 房间消息事件
  • 自定义卡片消息
    • 自定义卡片编辑器
    • 物料组件
      • 卡片
      • 文本
      • 标题
      • 图片
      • 按钮组
      • 分割线
      • 倒计时
  1. 房间接口

修改权限组或成员权限

开发中
POST
https://chat.xiaoheihe.cn/chatroom/v2/role/role_user_perm

服务器权限管理文档#

通用服务器权限#

权限名称位标识描述
管理员1 << 0管理员权限
查看频道1 << 1查看频道权限
编辑、管理频道1 << 2编辑和管理频道权限
查看审核日志1 << 3查看审核日志权限
管理角色1 << 4管理角色权限
管理房间1 << 5管理房间权限
管理语句1 << 28管理语句权限
修改频道内其他人的邀约1 << 29修改频道内其他人的邀约权限
管理表情包1 << 30管理表情包权限
管理语音包1 << 31管理语音包权限
播放语音包1 << 32播放语音包权限
播放伴奏1 << 33播放伴奏权限
共享屏幕1 << 34共享屏幕权限
游戏组队1 << 35游戏组队权限
房间活动管理1 << 38房间活动管理权限

成员身份权限#

权限名称位标识描述
创建邀请1 << 6创建邀请权限
管理邀请1 << 7管理邀请权限
修改昵称1 << 8修改昵称权限
管理昵称1 << 9管理昵称权限
踢出房间1 << 10踢出房间权限
踢出频道1 << 11踢出频道权限
封锁成员1 << 12封锁成员权限
临时禁言成员1 << 13临时禁言成员权限

文字频道权限#

权限名称位标识描述
发送消息1 << 14发送消息权限
上传文件1 << 15上传文件权限
@ 群组1 << 16@ 群组权限
添加表情1 << 17添加表情权限
管理消息1 << 18管理消息权限
读取历史消息1 << 19读取历史消息权限
创建开黑邀约1 << 20创建开黑邀约权限
管理开黑邀约1 << 21管理开黑邀约权限
使用bot命令1 << 36使用bot命令权限
创建投票1 << 37创建投票权限
发送图片1 << 39在频道内发送图片或markdown格式的图片消息权限

语音频道权限#

权限名称位标识描述
加入语音频道1 << 22加入语音频道权限
说话1 << 23说话权限
使用自由麦1 << 24使用自由麦权限
频道静音1 << 25频道静音权限
静音某人1 << 26静音某人权限
移动成员1 << 27移动成员权限
开启录音1 << 40开启录音权限

请求参数

Authorization
在 header 添加参数
token
示例：
token: ********************
Query 参数
heybox_id
string 
必需
示例值:
25123062^
client_type
string 
声明请求黑盒语音
必需
默认值:
heybox_chat
x_client_type
string 
声明客户端类型
必需
默认值:
web
os_type
string 
声明客户端类型
必需
默认值:
web
x_os_type
string 
声明客户端是bot
必需
默认值:
bot
x_app
string 
声明请求黑盒语音
必需
默认值:
heybox_chat
chat_os_type
string 
声明客户端是bot
必需
默认值:
bot
chat_version
string 
必需
客户端版本号,不同版本返回的结果可能有区别
默认值:
1.30.0
Header 参数
Content-Type
string 
必需
示例值:
application/json;charset=utf-8
Body 参数application/json
room_id
string 
房间id
必需
channel_id
string 
频道id
必需
roles
array [object {4}] 
必需
role_id
string 
权限组id
可选
allow
string 
允许的权限位
可选
deny
string 
拒绝的权限位
可选
channel_type
integer 
频道类型
可选
users
array [object {3}] 
必需
to_user_id
integer 
用户id
可选
allow
string 
允许的权限位
可选
deny
string 
拒绝的权限位
可选
示例
{"room_id":"3379814836102766592","channel_id":"3826248018093834240","roles":[{"role_id":"3826461204583522310","allow":"4194306","deny":"0","channel_type":0}],"users":[{"to_user_id":2663671,"allow":"4194306","deny":"0"}]}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://chat.xiaoheihe.cn/chatroom/v2/role/role_user_perm?heybox_id=25123062^&client_type=&x_client_type=&os_type=&x_os_type=&x_app=&chat_os_type=&chat_version=' \
--header 'Content-Type: application/json;charset=utf-8' \
--header 'token;' \
--data-raw '{"room_id":"3379814836102766592","channel_id":"3826248018093834240","roles":[{"role_id":"3826461204583522310","allow":"4194306","deny":"0","channel_type":0}],"users":[{"to_user_id":2663671,"allow":"4194306","deny":"0"}]}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
修改于 2025-07-23 02:28:57
上一页
设置频道密码
下一页
在线媒体流说明文档
Built with