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

获取用户房间内语音游戏时长

开发中
GET
https://chat.xiaoheihe.cn/chatroom/api/duration/chat
时间跨度不能超过30天
appid可通过获取房间信息中的bind_game_infos获取

请求参数

Authorization
在 header 添加参数
token
示例:
token: ********************
Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://chat.xiaoheihe.cn/chatroom/api/duration/chat?room_id&begin_time&end_time&appid' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI4ODM2MjU3IiwiYXVkIjpbImZlOTM5N2MxLTUzODQtNDIxZi04MGFlLTI2ZDIxMGQ0NDU0YyJdLCJleHAiOjE3NTM5NDk1NDl9.X4MsIDy1udt3yOoWW_n8EtjZxygoUFuC4tdALBZgNVM' \
--header 'token: <api-key>'

返回响应

🟢200成功
application/json
Body

示例
{
    "msg": "",
    "result": {
        "durations": [
            {
                "room_id": 3379814836102766592,
                "user_id": 84122008,
                "create_at": "2025-08-06T07:40:14.926Z",
                "update_at": "1970-01-01T00:00:00Z",
                "duration": 10
            },
            {
                "room_id": 3379814836102766592,
                "user_id": 84122008,
                "create_at": "2025-08-06T07:40:38.76Z",
                "update_at": "1970-01-01T00:00:00Z",
                "duration": 6
            }
        ]
    },
    "status": "ok"
}
修改于 2025-10-10 06:13:00
上一页
获取用户房间内语音时长
下一页
获取用户信息-自动触发授权
Built with