HTTP连接
众所周知,go-cq有很多api,很多都很方便,但是一直没在网上找到调用方式,于是就写下了这篇文章。首先参考github上的官方配置开启http链接,格式如下:
# go-cqhttp 默认配置文件
account: # 账号相关
uin: 1233456 # QQ账号
password: '' # 密码为空时使用扫码登录
encrypt: false # 是否开启密码加密
status: 0 # 在线状态 请参考 https://docs.go-cqhttp.org/guide/config.html#在线状态
relogin: # 重连设置
delay: 3 # 首次重连延迟, 单位秒
interval: 3 # 重连间隔
max-times: 0 # 最大重连次数, 0为无限制
# 是否使用服务器下发的新地址进行重连
# 注意, 此设置可能导致在海外服务器上连接情况更差
use-sso-address: true
heartbeat:
# 心跳频率, 单位秒
# -1 为关闭心跳
interval: 5
message:
# 上报数据类型
# 可选: string,array
post-format: string
# 是否忽略无效的CQ码, 如果为假将原样发送
ignore-invalid-cqcode: false
# 是否强制分片发送消息
# 分片发送将会带来更快的速度
# 但是兼容性会有些问题
force-fragment: false
# 是否将url分片发送
fix-url: false
# 下载图片等请求网络代理
proxy-rewrite: ''
# 是否上报自身消息
report-self-message: false
# 移除服务端的Reply附带的At
remove-reply-at: false
# 为Reply附加更多信息
extra-reply-data: false
# 跳过 Mime 扫描, 忽略错误数据
skip-mime-scan: false
output:
# 日志等级 trace,debug,info,warn,error
log-level: warn
# 日志时效 单位天. 超过这个时间之前的日志将会被自动删除. 设置为 0 表示永久保留.
log-aging: 15
# 是否在每次启动时强制创建全新的文件储存日志. 为 false 的情况下将会在上次启动时创建的日志文件续写
log-force-new: true
# 是否启用 DEBUG
debug: false # 开启调试模式
# 默认中间件锚点
default-middlewares: &default
# 访问密钥, 强烈推荐在公网的服务器设置
access-token: ''
# 事件过滤器文件目录
filter: ''
# API限速设置
# 该设置为全局生效
# 原 cqhttp 虽然启用了 rate_limit 后缀, 但是基本没插件适配
# 目前该限速设置为令牌桶算法, 请参考:
# https://baike.baidu.com/item/%E4%BB%A4%E7%89%8C%E6%A1%B6%E7%AE%97%E6%B3%95/6597000?fr=aladdin
rate-limit:
enabled: false # 是否启用限速
frequency: 1 # 令牌回复频率, 单位秒
bucket: 1 # 令牌桶大小
# 连接服务列表
servers:
# 添加方式,同一连接方式可添加多个,具体配置说明请查看文档
- http: # http 通信
address: 127.0.0.1:5700
timeout: 5
middlewares:
<<: *default # 引用默认中间件
#- ws: # 正向 Websocket
#- ws-reverse: # 反向 Websocket
#- pprof: #性能分析服务器
# 反向WS设置
- ws-reverse:
# 反向WS Universal 地址
# 注意 设置了此项地址后下面两项将会被忽略
universal: ws://127.0.0.1:xxxx/onebot/v11/ws
# 反向WS API 地址
api: ws://your_websocket_api.server
# 反向WS Event 地址
event: ws://your_websocket_event.server
# 重连间隔 单位毫秒
reconnect-interval: 3000
middlewares:
<<: *default # 引用默认中间件
重点在http通信的设置,按照上面的设置的话,以下面这个api为例
![](https://i-blog.csdnimg.cn/blog_migrate/5bf1d180119089bc9f00d6d360becc88.png)
访问的链接就是
127.0.0.1:5700/get_guild_service_profile
返回数据如下
![](https://i-blog.csdnimg.cn/blog_migrate/b71a355073280c0d6c499d1a09735324.png)
其他api带参数的使用方式如下,比如
![](https://i-blog.csdnimg.cn/blog_migrate/210888a7ac35edb08b41fcc68812f851.png)
127.0.0.1:5700/get_guild_service_profile?guild_id=xxxxxx
若有多个参数,中间加上&即可
nonebot2连接
群api用bot.call_api(api,参数)即可,具体例子如下
![](https://i-blog.csdnimg.cn/blog_migrate/26861e280a2c2bbee6ec3411a1557ae2.png)
频道api用bot.api(参数),具体例子如下
![](https://i-blog.csdnimg.cn/blog_migrate/fd19c10d32f7ad73b8500ce531d87e72.png)