LLOneBot
  1. 接口列表
LLOneBot
  • 接口列表
    • LLOneBot 接口文档
    • HTTP 调用/接收消息
    • Websocket 发送/接受消息
    • 用户
      • 点赞
      • 好友列表
      • 好友列表(带分组)
      • 删除好友
      • 处理好友申请
      • 设置好友备注
      • 获取好友或群友信息
      • 设置个人头像
      • 好友戳一戳(双击头像)
      • 上传私聊文件
      • 获取我赞过谁列表
      • 获取谁赞过我列表
      • 获取官方机器人QQ号范围
      • 移动好友分组
    • 群组
      • 群列表
      • 群详情
      • 群成员列表
      • 获取群成员信息
      • 群员戳一戳(双击头像)
      • 获取群系统消息
      • 处理加群请求
      • 退群
      • 设置群管理员
      • 设置群名片
      • 群禁言
      • 群全体禁言
      • 设置群名
      • 群踢人
      • 设置群头衔
      • 群荣誉
      • 获取群精华消息
      • 设置群精华消息
      • 删除群精华消息
      • 获取群根目录文件列表
      • 上传群文件
      • 删除群文件
      • 创建群文件文件夹
      • 删除群文件文件夹
      • 获取群文件资源链接
      • 获取群 @全体成员 剩余次数
      • 发送群公告
      • 获取群公告
      • 群打卡
      • 设置群消息接受方式
      • 设置群备注
      • 获取已过滤的加群通知
    • 消息
      • 发送私聊消息
        • 发送私聊文本消息
        • 发送私聊回复消息
        • 发送私聊图片
        • 发送私聊文字+图片
        • 发送私聊系统表情
        • 发送私聊语音消息
        • 发送私聊视频消息
        • 发送私聊超级表情 骰子
        • 发送私聊超级表情 猜拳
        • 发送私聊QQ音乐卡片
        • 发送私聊网易云音乐卡片
        • 发送私聊自定义音乐卡片
        • 发送私聊卡片(json)消息
        • 发送私聊合并转发消息
      • 发送群聊消息
        • 发送群聊文本消息
        • 发送群聊回复消息
        • 发送群聊@消息
        • 发送群聊图片
        • 发送群聊文字+图片
        • 发送群聊系统表情
        • 发送群聊语音消息
        • 发送群聊视频消息
        • 发送群聊超级表情 骰子
        • 发送群聊超级表情 猜拳
        • 发送群聊QQ音乐卡片
        • 发送群聊网易云音乐卡片
        • 发送群聊自定义音乐卡片
        • 发送群聊卡片(json)消息
        • 发送群聊合并转发消息
      • 转发单条好友消息
      • 转发单条群消息
      • 获取消息详情
      • 撤回消息
      • 获取消息文件详情
      • 获取消息图片详情
      • 获取消息语音详情
      • 表情回应消息
      • 取消消息表情回应
      • 获取好友历史消息记录
      • 获取群历史消息
      • 获取转发消息详情
      • 标记消息已读
    • 系统
      • 获取登录号信息
      • 获取版本信息
      • bot状态
      • 清理缓存
      • 下载文件到bot所在
      • 获取cookies
      • 设置在线状态
      • 图片 OCR
      • 获取收藏表情
      • 重启
  1. 接口列表

Websocket 发送/接受消息

Websocket 连接有正向和反向两种#

正向的意思是 Bot 端为 Websocket 服务器,你的插件需要主动去连接它,
反向的意思是 Bot 端作为客户端,你的插件作为服务端,Bot 端会主动连接你的插件端。

调用接口的方式#

和 Bot 建立 Websocket 链接后,发送一个 JSON
{
    "action": "send_group_msg",
    "params": {
      "group_id": 545402644,
      "message": [
        {
          "type": "text",
          "data": {
            "text": "HelloKitty"
          }
        }
      ]
    },
    "echo": "唯一标识,如 uuid"
}
action 对应的接口名和 HTTP 的一致,具体有哪些接口名可以在左侧接口列表查看。
params 则和 HTTP 接口提交的 JSON 一致。
echo 发送和返回都会带有此字段,用于 Websocket 发送请求后返回的对应,由于 Websocket 是长连接,同一时间可能会有很多返回,因此需要一个唯一标识符,这样才能识别自己调用的接口后返回的数据。
同时这个 Websocket 连接也会接收到 Bot 的消息和事件上报。

下面是一个正向 Websocket 的 Python 示例#

需要先安装 websockets 包,pip install websockets
在 LLOneBot 启用 Websocket 正向,并填入端口 3001。
然后运行上面的 Python 代码,输入群号后开始打印收到的消息,再输入任意内容按回车会往刚刚输入的群号发送消息。

下面是反向 Websocket 的 Python 示例#

需要先安装 websockets 包,pip install websockets
在 LLOneBot 启用 Websocket 反向,并填入反向地址 ws://localhost:8765
运行上面的 Python 代码后,输入群号后开始打印收到的消息,再输入任意内容按回车会往刚刚输入的群号发送消息。
修改于 2025-01-24 07:28:07
上一页
HTTP 调用/接收消息
下一页
点赞
Built with