# 方法

# SendPrivateMsg

SendPrivateMsg(string, int64) (map[string]interface{}, error)
1
  • 发送私聊信息

参数

字段 类型 说明
message string 消息内容 自动解析CQ码
user_id int64 对方QQ号

响应

字段 类型 说明
message_id map[string]interface{} 短事件回调内容
error error 错误

# SendGroupMsg

SendGroupMsg(string, int64) (map[string]interface{}, error)
1
  • 发送群聊消息

参数

字段 类型 说明
message string 要发送的内容
group_id int64 群号

响应

字段 类型 说明
message_id map[string]interface{} 短事件回调内容
error error 错误

# SendMsg

SendMsg(string, string, int64) (map[string]interface{}, error)
1
  • 发送消息(本条API并不是 Onebot/CQhttp 原生API)

参数

字段 类型 说明
msgtype string 消息类型 group/private
message string 消息内容
toid int64 群号/QQ号

响应

字段 类型 说明
message_id map[string]interface{} 短事件回调内容
error error 错误

# DeleteMsg

DeleteMsg(int32) error
1
  • 撤回消息

参数

字段 类型 说明
message_id int32 消息id 发出时的返回值

响应

字段 类型 说明
error error 错误

# GetMsg

GetForwardMsg(string) (map[string]interface{}, error)
1
  • 获取信息

参数

字段 类型 说明
message_id int32 获取消息

响应

字段 类型 说明
message {time message_type message_id real_id sender message} 消息详情
error error 错误

# GetForwardMsg

GetForwardMsg(string) (map[string]interface{}, error)
1
  • 获取合并转发消息

参数

字段 类型 说明
id int32 获取合并转发 ID

响应

字段 类型 说明
message forward message[] (opens new window) 消息列表
err error 错误

# SendLike

SendLike(int64, int64) error
1
  • 发送好友赞

参数

字段 类型 说明
user_id int64 对方QQ号
times int64 点赞次数(每个好友每天最多 10 次)

响应

字段 类型 说明
err error 错误

# SetGroupKick

SetGroupKick(int64, int64, bool) error
1
  • 群组踢人

参数

字段 类型 说明
group_id int64 群号
user_id int64 要踢的 QQ 号
reject_add_request bool 是否拒绝再次入群

响应

字段 类型 说明
err error 错误

# SetGroupBan

SetGroupBan(int64, int64, int64) error
1
  • 群组单人禁言

参数

字段 类型 说明
group_id int64 群号
user_id int64 要禁言的QQ号
duration int64 禁言时长(s) 0表示取消禁言

响应

字段 类型 说明
err error 错误

# SetGroupAnonymousBan

SetGroupAnonymousBan(int64, string, int64) error
1
  • 群组匿名用户禁言

参数

字段 类型 说明
group_id int64 群号
anymous_flag string 匿名用户的 flag(需从群消息上报的数据中获得)
duration int64 禁言时长(s) 0表示取消禁言

响应

字段 类型 说明
err error 错误

# SetGroupWholeBan

SetGroupWholeBan(int64, bool) error
1
  • 群全员禁言

参数

字段 类型 说明
group_id int64 群号
enable bool 是否禁言

响应

字段 类型 说明
err error 错误

# SetGroupAdmin

SetGroupAdmin(int64, int64, bool) error
1
  • 群组设置管理员(需要机器人为群主)

参数

字段 类型 说明
group_id int64 群号
user_id int64 QQ号
enable bool true 为设置,false 为取消

响应

字段 类型 说明
err error 错误

# SetGroupAnonymous

SetGroupAnonymous(int64, bool) error
1
  • 群组匿名

参数

字段 类型 说明
group_id int64 群号
enable bool 是否允许匿名聊天

响应

字段 类型 说明
err error 错误

# SetGroupCard

SetGroupCard(int64, int64, string) error
1
  • 设置群名片

参数

字段 类型 说明
group_id int64 群号
user_id int64 成员QQ
card string 空字符串表示删除群名片

响应

字段 类型 说明
err error 错误

# SetGroupName

SetGroupName(int64, string) error
1
  • 设置群名

参数

字段 类型 说明
group_id int64 群号
group_name string 新群名

响应

字段 类型 说明
err error 错误

# SetGroupLeave

SetGroupLeave(int64, bool) error
1
  • 退群

参数

字段 类型 说明
group_id int64 群号
is_dismiss bool 是否解散,如果登录号是群主,则仅在此项为 true 时能够解散

响应

字段 类型 说明
err error 错误

# SetGroupSpecialTitle

SetGroupSpecialTitle(int64, int64, string) error
1
  • 设置群组专属头衔

参数

字段 类型 说明
group_id int64 群号
user_id int64 成员QQ
special_title string 空字符串表示删除专属头衔

响应

字段 类型 说明
err error 错误

# SetFriendAddRequest

SetFriendAddRequest(string, bool) error
1
  • 处理加好友请求

参数

字段 类型 说明
flag string 加好友请求的 flag(需从上报的数据中获得)
approve bool 是否同意请求

响应

字段 类型 说明
err error 错误

# SetGroupAddRequest

SetGroupAddRequest(string, bool, string) error
1
  • 处理加群请求

参数

字段 类型 说明
flag string 加群请求的 flag
approve bool 是否同意邀请
reason string 拒绝理由(只有在拒绝时有效)

响应

字段 类型 说明
err error 错误

# SetGroupInviteRequest

SetGroupInviteRequest(string, bool, string) error
1
  • 处理加群邀请

参数

字段 类型 说明
flag string 加群邀请的 flag
approve bool 是否同意邀请
reason string 拒绝理由(只有在拒绝时有效)

响应

字段 类型 说明
err error 错误

# GetLoginInfo

GetLoginInfo()
1
  • 获取登录号信息

参数

响应

字段 类型 说明
info {user_id nickname} 登录信息
err error 错误

提示

以下为 CQhttp 的API

# GetImage

GetImage(string)
1
  • 获取图片信息

参数

字段 类型 说明
file string 图片缓存文件名

响应

字段 类型 说明
size int32 图片源文件大小
filename string 图片文件原名
url string 图片下载地址
err error 错误

# OCRImage

OCRImage(string)
1
  • 图片OCR

参数

字段 类型 说明
image file string 图片ID

响应

字段 类型 说明
result textsTextDetection[] OCR结果
err error 错误

textsTextDetection[]:

字段 类型 说明
text string 文本
confidence int32 置信度
coordinates vector2 坐标
language string 语言