黑盒语音接口
  1. 消息接口
黑盒语音接口
  • 教程
  • 开发者服务协议
  • 使用交流
  • 更新日志
  • 开发计划
  • 资源
    • 请求速率限制
    • Websocket
    • Bot命令
  • WEBSOCKET 连接请求
    • 连接到黑盒语音服务
  • HTTP接口
    • 消息接口
      • 发送消息接口的参数
      • 发送消息接口的返回值
      • 发送图片形式的频道消息
      • 发送Markdown文档
      • 更新指定频道消息
      • 删除指定的频道消息
      • 对某条频道消息增加/取消回应(小表情)
      • 发送卡片消息
      • 给用户发送私聊消息
      • 发送频道图片消息
        POST
      • 发送频道消息
        POST
      • 发送卡片消息
        POST
      • 发送频道消息@全体成员/@在线成员
        POST
      • 更新指定的频道消息
        POST
      • 删除指定的频道消息
        POST
      • 对某条频道消息增加/取消回应(小表情)
        POST
      • 给用户发送私聊消息
        POST
    • 媒体文件上传
      • 上传媒体文件的参数解析
      • 上传媒体文件
    • 房间角色接口
      • 权限相关说明
      • 接口说明
      • 获取房间角色列表
      • 创建角色
      • 更新角色
      • 删除角色
      • 对指定用户授予指定权限
      • 对指定用户剥夺指定权限
    • 房间表情
      • 房间表情包
      • 获取房间上传的表情包
      • 房间删除表情包
      • 房间更新表情包名称
    • 房间接口
      • 房间相关接口文档
      • 修改房间内昵称
      • 分页获取加入的房间列表
      • 获取房间信息
      • 退出房间
      • 房间踢人
      • 获取房间用户列表
  • 服务端推送事件
    • 事件说明
    • 通用推送字段
    • 机器人命令
      • 用户使用Bot命令
    • 频道消息事件
      • 频道消息事件
    • 房间消息事件
      • 房间消息事件
  1. 消息接口

发送Markdown文档

黑盒语音是支持发送Markdown文档的,消息type=4或者10的时候则为markdown形式的文档

Markdown 的特点#

1.
简洁明了:Markdown 语法简单易懂,易于学习和使用,能够让消息编写更加高效。
2.
可读性高:Markdown 文档以纯文本形式呈现,无需复杂的排版和样式,使得消息更加易读。

基础语法及展示#

标题#

用#号定义标题,#号数量代表标题层级。目前仅支持2级标题,更多的#是不起作用的
请求示例:
{
    "msg": "# 一级标题\n\n## 二级标题\n\n### 三级标题\n\n#### 四级标题\n\n##### 五级标题\n\n###### 六级标题",
    "msg_type": 4,
    "heychat_ack_id": "0",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{}",
    "channel_id": "3697241303357612034",
}
示意图:

文本#

支持大多数标记格式。通过在文本前后添加 “**” 实现粗体,添加 “*” 实现倾斜,添加 “~~” 实现删除线的格式。还支持上标<sup>上标格式文本</sup>和下标<sub>下标格式文本</sub>。此外,还可以添加链接,如[黑盒语音官网](https://chat.xiaoheihe.cn/home/index)
请求示例:
{
    "msg": "**粗体文本内容**\n\n *斜体文本内容*\n\n ~~这是一段被删除的文字~~\n\n正常文本 <sup>上标格式文本</sup> \n\n正常文本 <sub>下标格式文本</sub> \n\n[黑盒语音官网](https://chat.xiaoheihe.cn/home/index)",
    "msg_type": 4,
    "heychat_ack_id": "0",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{}",
    "channel_id": "3697241303357612034"
}
示意图:

图片#

在Markdown中嵌入图片#

按照 ![xxx](path)的格式来插入图片。
请求示例:
{
    "msg": "![lol](https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg)",
    "msg_type": 4,
    "heychat_ack_id": "2",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{}",
    "channel_id": "3697241303357612034",
    "channel_type": 1
}
示意图:

指定图片尺寸#

请求示例:
{
    "msg": "![lol](https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg)",
    "msg_type": 4,
    "heychat_ack_id": "2",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{\"img_files_info\":[{\"url\":\"https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg\",\"width\":200,\"height\":200}]}",
    "channel_id": "3697241303357612034",
}
示意图:

列表#

有序列表#

使用数字加 “.” 的方式创建有序列表。
请求示例:
{
    "msg": "1.  A\n\n  2.  B\n\n  3.  C\n\n  4.  D",
    "msg_type": 4,
    "heychat_ack_id": "2",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{\"img_files_info\":[{\"url\":\"https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg\",\"width\":200,\"height\":200}]}",
    "channel_id": "3697241303357612034"
}
示意图:

无序列表#

请求示例:
使用 “* ” 创建无序列表。
{
    "msg": "* 这是\n\n* 无序\n\n* 列表",
    "msg_type": 4,
    "heychat_ack_id": "2",
    "reply_id": "",
    "room_id": "3697241302130286592",
    "addition": "{\"img_files_info\":[{\"url\":\"https://imgheybox.max-c.com/dev/bbs/2024/10/22/6b8294b99f3499cbcb8da8d98b12dc58.jpeg\",\"width\":200,\"height\":200}]}",
    "channel_id": "3697241303357612034"
}
示意图:
修改于 2024-11-05 07:51:25
上一页
发送图片形式的频道消息
下一页
更新指定频道消息
Built with