酷Q社区»社区 酷Q 应用发布 · 创意

[免费(开源)] HTTP API 插件[复制链接]

作者: richardchien|查看: 54916|回复: 335
跳转到指定楼层
2017-1-28 14:02
HTTP API4.0.0
appidio.github.richardchien.CoolQhttpapiV9
交流群QQ群 201865589
类型网络 工具 云接口 
许可开放源代码 (开源)必须保留原作者版权
介绍通过 HTTP 上报事件信息及调用接口

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有帐号?注册

x
本帖最后由 qqqqqwtf 于 2018-6-7 22:39 编辑

通过 HTTP 对酷 Q 的事件进行上报以及接收 HTTP 请求来调用酷 Q 的 DLL 接口,从而可以使用其它语言编写酷 Q 插件。现已支持 WebSocket。对于某些语言现也提供官方或第三方的 SDK,封装了 HTTP 相关的操作,让你更专注于插件功能的开发。

网站:https://cqhttp.cc,文档:https://cqhttp.cc/docs/,文档国内地址:http://richardchien.gitee.io/coolq-http-api/docs/,GitHub:https://github.com/richardchien/coolq-http-api,大家如果有问题请到 GitHub 发 issue 来反馈和讨论,也可以加入 QQ 交流群,论坛这里我不一定能及时回复。

使用方法

手动安装

直接到 Releases 下载最新的 cpk 文件放到酷 Q 的 app 文件夹,然后启用即可。由于要上报事件、接受调用请求,因此需要所有权限。如果 Releases 里面下载不了,也可以去 百度网盘 下载。

注意如果酷 Q 启动时报错说插件加载失败,或者系统弹窗提示缺少 DLL 文件,则需要安装
VC++ 2017 运行库,如果你的系统是 Windows 7 或 Windows Server 2008、或者安装 VC++ 2017 运行库之后仍然加载失败,则还需要安装 通用 C 运行库更新,在这个链接里选择你系统对应的版本下载安装即可。如果此时还加载失败,请尝试重启系统。

启用后插件将开启一个 HTTP 服务器来接收请求,默认监听 0.0.0.0:5700,首次启用会生成一个默认配置文件,在酷 Q 的 app\io.github.richardchien.coolqhttpapi\config 文件夹中,文件名为 <user_id>.json<user_id> 为登录的 QQ 号),使用 JSON 格式填写。关于配置项的说明,见
配置

此时通过 http://192.168.1.123:5700/ 即可调用酷 Q 的函数,例如 http://192.168.1.123:5700/send_private_msg?user_id=123456&message=你好,注意这里的 192.168.1.123 要换成你自己电脑的 IP,如果在本地跑,可以用 127.0.0.1user_id 也要换成你想要发送到的 QQ 号。具体的 API 列表见
API 描述。如果需要使用 HTTPS 来访问,见 HTTPS

酷 Q 收到的消息、事件会被 POST 到配置文件中指定的 post_url,为空则不上报。上报数据格式见 上报数据格式

停用插件将会关闭 HTTP 线程,再次启用将重新读取配置文件。


除了 HTTP 方式,现在还支持 WebSocket 和反向 WebSocket 两种通信方式,它们的适用场景和使用方法见 通信方式

另外,本插件所支持的 CQ 码在原生的基础上进行了一些增强,见 CQ 码,并且支持以字符串或数组格式表示消息,见 消息格式

对于其它可能比较容易遇到的问题,见 FAQ

使用 Docker

如果你使用 docker 来部署服务,请阅读
使用 Docker


SDK

对于常用的主流编程语言,社区中的开发者们已经贡献了很多可用的 SDK,见
SDK

应用案例

除了 SDK,社区中还有大量已用于线上的应用案例可供参考,见 应用案例


被感谢 34

前排支持

被感谢 1

不知道干什么的。。
+1同上
我去厉害了
很强大,要是我早点看到就好了
亲 文本 换行  换行符 是什么啊?

RE: HTTP API 插件

holy2011 发表于 2017-2-17 18:24
亲 文本 换行  换行符 是什么啊?

所有的发送消息的内容都和酷 Q 原生的接口完全一样,使用酷 Q 的 SDK 怎么发,使用这个 HTTP 插件就怎么发,换行符就是 "\n"
朋友可以跟你定制吗~~需要一些功能~~

RE: HTTP API 插件

qinlongpk 发表于 2017-2-17 23:35
朋友可以跟你定制吗~~需要一些功能~~

你要什么功能……我未必能写
楼主  你这个插件很强大,但是我看了一上午硬是不知道如何开发对接  样例也没有

RE: HTTP API 插件

macuobie 发表于 2017-2-20 12:11
楼主  你这个插件很强大,但是我看了一上午硬是不知道如何开发对接  样例也没有 ...

文档写得很详细了吧…… https://richardchien.github.io/coolq-http-api/
这插件好强,666

RE: HTTP API 插件


谢谢~
都说好强 完全不知道能干什么  是不是通过HTTP发消息用的?
启动这个插件后,没有修改配置文件,用浏览器访问http://192.168.1.123:5700/send_p ... 123456&message=你好
没有任何反应,浏览器返回:192.168.1.123 的响应时间过长。
请问是不是哪里没弄好?
请问作者一个问题,插件把时间POST到接口上去了之后,接口可以返回对应的操作吗? 数据返回的流程是和主动调用API是一样的吗?

RE: HTTP API 插件

李威兵 发表于 2017-3-3 23:24
都说好强 完全不知道能干什么  是不是通过HTTP发消息用的?

是的,还有通过 HTTP 收消息和事件

RE: HTTP API 插件

huzhiyang 发表于 2017-3-5 23:43
启动这个插件后,没有修改配置文件,用浏览器访问http://192.168.1.123:5700/send_private_msg?user_id=123 ...

我这里给的 192.168.1.123 是示例的,你要换成你运行这个程序的设备的 IP 地址,如果你是在本地跑的,可以用 127.0.0.1

RE: HTTP API 插件

JadeLiu 发表于 2017-3-6 14:24
请问作者一个问题,插件把时间POST到接口上去了之后,接口可以返回对应的操作吗? 数据返回的流程是和主动 ...

现在暂时不能通过接口直接返回的数据来进行操作,只能去主动反向地调用 API
您需要登录后才可以回帖 登录 | 注册

本版积分规则尽量使你的回复能够对他人有所帮助

Powered by Discuz!Designed by hexapp© 2020 CoolQ

快速回复返回顶部返回列表