Skip to content

Latest commit

 

History

History
324 lines (213 loc) · 6.64 KB

WebhookAdapter.md

File metadata and controls

324 lines (213 loc) · 6.64 KB

Webhook Adapter

提供 http 回调形式的接口, 可单纯做上报使用

配置文件

adapterSettings:
  webhook:
    ## 回调(上报)地址
    destinations: 
    - 'localhost:9999/path1'
    - 'localhost:9999/path2'
    - 'localhost:9999/path3'

    ## 额外自定义请求头
    extraHeaders:
      Authorization: 'bearer SV*(&*(SH@ID^G'
      header1: value1
      header2: value2

    ## 超时时间,默认都是 10 秒
    timeout:
      ## 从请求到取得响应的超时时间
      requestTimeoutMillis: 10000
      ## connectTimeoutMillis
      connectTimeoutMillis: 10000
      ## socketTimeoutMillis, 即 read timeout 和 write timeout
      socketTimeoutMillis: 10000

接口一览

专有接口


通用接口

webhook只支持部分操作

数据格式

webhook 不会接收主动请求, 只会接收到事件后向知道地址进行 http 上报. 但远端服务器可以通过 “响应” 进行简单的操作.

webhook 上报的内容为消息、事件的对象 消息类型事件类型

http 请求会携带配置文件中定义的请求头,以及固定的请求头 qq: xxxxxx, 以表示收到消息事件的账号

上报格式

消息、事件的 json 对象格式

返回格式

// headers
// content-type: "application/json"

// http body:
{
  command: "",  // 命令字
  content: {}   // 命令内容
}

消息发送与撤回

发送好友消息

使用此方法向指定好友发送消息

命令字: sendFriendMessage

通用接口定义: 发送好友消息

发送群消息

命令字: sendGroupMessage

通用接口定义: 发送群消息

发送临时会话消息

命令字: sendTempMessage

通用接口定义: 发送临时会话消息

发送头像戳一戳消息

命令字: sendNudge

通用接口定义: 发送头像戳一戳消息

撤回消息

命令字: recall

通用接口定义: 撤回消息

账号管理

删除好友

使用此方法删除指定好友

命令字: deleteFriend

通用接口定义: 删除好友

群管理

禁言群成员

使用此方法指定群禁言指定群员(需要有相关限权)

命令字: mute

通用接口定义: 禁言群成员

解除群成员禁言

使用此方法指定群解除群成员禁言(需要有相关限权)

命令字: unmute

通用接口定义: 解除群成员禁言

移除群成员

使用此方法移除指定群成员(需要有相关限权)

命令字: kick

通用接口定义: 移除群成员

退出群聊

使用此方法使Bot退出群聊

命令字: quit

通用接口定义: 退出群聊

全体禁言

使用此方法令指定群进行全体禁言(需要有相关限权)

命令字: muteAll

通用接口定义: 全体禁言

解除全体禁言

使用此方法令指定群解除全体禁言(需要有相关限权)

命令字: unmuteAll

通用接口定义: 解除全体禁言

设置群精华消息

使用此方法添加一条消息为精华消息(需要有相关限权)

命令字: setEssence

通用接口定义: 设置群精华消息

修改群设置

使用此方法修改群设置(需要有相关限权)

命令字: groupConfig
子命令字: update

通用接口定义: 修改群设置

修改群员设置

使用此方法修改群员设置(需要有相关限权)

命令字: memberInfo
子命令字: update

通用接口定义: 修改群员设置

修改群员管理员

使用此方法修改群员的管理员权限(需要有群主限权)

命令字: memberAdmin

通用接口定义: 修改群员管理员

群公告

获取群公告

此方法获取指定群公告列表

命令字: anno_list

通用接口定义: 获取群公告

发布群公告

此方法向指定群发布群公告

命令字: anno_publish

通用接口定义: 发布群公告

删除群公告

此方法删除指定群中一条公告

命令字: anno_delete

通用接口定义: 删除群公告

事件处理

添加好友申请

使用此方法处理添加好友申请

命令字: resp_newFriendRequestEvent

通用接口定义: 添加好友申请

用户入群申请

使用此方法处理用户入群申请

命令字: resp_memberJoinRequestEvent

通用接口定义: 用户入群申请

Bot被邀请入群申请

使用此方法处理Bot被邀请入群申请

命令字: resp_botInvitedJoinGroupRequestEvent

通用接口定义: Bot被邀请入群申请