通过 HTTP 或 WebSocket 对酷 Q 的事件进行上报以及接收请求来调用酷 Q 的 DLL 接口，从而可以使用其它语言编写酷 Q 插件。支持 Windows 7 和 Windows Server 2008 及更新版本，也可以运行在 Wine、Docker。
使用方法见 https://cqhttp.cc/docs/。v1.x、v2.x 的旧版本文档在 https://cqhttp.cc/docs/legacy/。
如果访问这个文档非常慢，请尝试国内的地址 http://richardchien.gitee.io/coolq-http-api/docs/。
对于下面这些语言的开发者，如果不想自己处理繁杂的请求和解析操作，可以尝试社区中开发者们已经封装好的的 SDK：
| 语言 | Web 框架 | 通信方式 | 插件版本 | 地址 | 作者 |
|---|---|---|---|---|---|
| Python | Quart | HTTP 反向 WebSocket |
4 | richardchien/python-aiocqhttp | richardchien |
| Python | Flask | HTTP | 3、4 | richardchien/python-cqhttp | richardchien |
| Node.js | WebSocket-Node | WebSocket | 3、4 | momocow/node-cq-websocket | momocow |
| Node.js | Koa | HTTP | 3、4 | richardchien/cqhttp-node-sdk | richardchien |
| PHP | 内置 | HTTP | 3、4 | kilingzhang/coolq-php-sdk | kilingzhang |
| PHP | Swoole | API: WebSocket Event: 反向 WebSocket |
3、4 | crazywhalecc/CQBot-swoole | crazywhalecc |
| Java | 内置 | HTTP | 4 | HyDevelop/PicqBotX | Hykilpikonna |
| Java | JFinal | HTTP | 3 | thevsk/cqhttp-java-jfinal-sdk | thevsk |
| Java | 内置 | HTTP | 3 | yangjinhe/maintain-robot | yangjinhe |
| Go | 内置 | API: HTTP、WebSocket Event: HTTP、长轮询、WebSocket、反向 WebSocket |
3、4 | catsworld/qq-bot-api | catsworld rikakomoe |
| Go | 内置 | HTTP | 3 | juzi5201314/cqhttp-go-sdk | juzi5201314 |
| Go | Gorilla WebSocket | WebSocket | 3 | ma6254/go-cqhttp | ma6254 |
| C# | 内置 | HTTP | 4 | int-and-his-friends/Sisters.WudiLib | bleatingsheep |
QQ 机器人可以用来做很多有意思的事情，下面列出一些基于本插件的开发框架和应用案例：
| 项目地址 | 简介 |
|---|---|
| richardchien/none-bot | 基于酷 Q 的 Python 异步 QQ 机器人框架 |
| Ray-Eldath/Avalon | 多功能、可扩展的 QQ 群机器人 |
| LovelyA72/YeziiBot-v1 | 内置一定实例的 PHP QQ 机器人快速开发框架 |
| kj415j45/kjBot | 使用 PHP 编写的轻量级多功能酷 Q 机器人框架 |
| trustgit/nodebot | 模块化、轻量化的，基于命令的 Node.js QQ 机器人框架 |
| milkice233/efb-qq-slave | 基于 ehForwarderBot 框架的 QQ 从端 |
| projectriri/bot-gateway | 提供跨聊天平台的通用机器人 API 的机器人消息网关 |
| jqqqqqqqqqq/coolq-telegram-bot | QQ <-> Telegram Bot Framework & Forwarder |
| Mother-Ship/cabbageWeb | 基于 Java Web 的 osu! 游戏数据查询机器人 |
| bdbai/Kobirt | Ingress 游戏辅助机器人 |
| JRT-FOREVER/hub2coolq | GitHub webhook 消息转发至 QQ 群 |
| Kurarion/Bangumi-for-QQ | 用于在 QQ 平台便捷地使用 Bangumi 部分功能（查寻条目、更新条目进度等） |
| rikakomoe/cqhttp-twitter-bot | 自动订阅 Twitter 发送到 QQ |
| XiaoLin0815/QQ2TG | 帮助 QQ 与 Telegram 互联的小程序 |
以上列出的只是实际应用中的一小部分，如果你使用本插件编写了任何好的应用案例或开发框架，也可以通过 issue 或 pull request 添加到这里的列表，共同充实社区。
如果你急需测试尚未发布的最新特性，可以前往 https://ci.appveyor.com/project/richardchien/coolq-http-api/build/artifacts 下载从 master 分支的最新代码构建出的 DLL 和 JSON 文件，将它们放入酷 Q 的 app 文件夹并开启酷 Q 的开发模式即可使用。
需要注意的是，master 分支所构建出的插件并不确保任何时候都是可用的，可能出现功能存在，但尚未完成的情况。
本项目使用 CMake 构建，依赖项通过 Vcpkg 管理。如果你没有使用过这两个工具，请先前往它们的官方网站了解基本用法。
可以直接用 VS Code 或 VS 打开项目，项目中的所有代码文件全部使用 UTF-8 编码，你后续添加的所有代码文件都需要使用 UTF-8 编码。注意，如果你使用 VS，则它默认使用 ANSI 编码保存文件，需要手动修改为 UTF-8。io.github.richardchien.coolqhttpapi.json 文件将在 scripts/post_build.ps1 脚本中被转换为酷 Q 要求的 GB18030 编码。
Vcpkg 使用如下 triplet：
set(VCPKG_TARGET_ARCHITECTURE x86)
set(VCPKG_CRT_LINKAGE dynamic)
set(VCPKG_LIBRARY_LINKAGE static)
set(VCPKG_PLATFORM_TOOLSET v141)
set(CURL_USE_WINSSL ON)你需要在 Vcpkg 的 triplets 文件夹中创建一个名为 my-x86-windows-static.cmake 的文件（文件名可以换为其它，但建议保留 x86-windows-static 这部分，似乎 Vcpkg 使用了文件名来判断要安装的包的版本），内容如上。创建了这个 triplet 之后，你需要将 scripts/generate.ps1 中的 $vcpkg_root（vcpkg 根目录）和 $vcpkg_triplet（triplet 名称，例如 my-x86-windows-static）设置成你系统中的相应值（或设置环境变量），如果你使用 VS Code 或 VS 编辑项目，可以直接修改 .vscode/tasks.json（VS Code）或 CMakeSettings.json（VS）中的 VCPKG_ROOT 和 VCPKG_TRIPLET 环境变量，注意，.vscode/tasks.json 中有两个 task 需要改。
除此之外，还需要安装如下依赖（使用上面的 triplet）：
| 模块 | 依赖项 |
|---|---|
cqsdk |
boost-algorithmlibiconv |
cqhttp |
cqsdk 的依赖项nlohmann-jsonboost-processcurllibssh2boost-property-treeboost-asioopensslspdlogsqlite3 |
安装命令如下：
cd vcpkg
git checkout 90e627c7e6312d5ab04060c186e55ac58edaa634 -- ports # 固定包版本到 2018 年 9 月 21 日
.\vcpkg --vcpkg-root . --triplet my-x86-windows-static install boost-algorithm libiconv nlohmann-json boost-process curl libssh2 boost-property-tree boost-asio openssl spdlog sqlite3构建成功后，可以在 build/Debug/Debug 或 build/Release/Release 中找到生成的 DLL 和 JSON 文件，直接拷贝到酷 Q 的 app 目录即可测试使用（酷 Q 需要开启开发模式）。
如果不想每次构建都手动拷贝这两个文件，可以在 scripts 目录添加文件 install.ps1（会被 post_build.ps1 在构建成功之后自动执行）如下：
$lib_name = $args[0]
$out_dir = $args[1]
$dll_name = "${lib_name}.dll"
$dll_path = "${out_dir}\${dll_name}"
$json_name = "${lib_name}.json"
$json_path = "${out_dir}\${json_name}"
Copy-Item -Force $dll_path "C:\Applications\CQA\app\${dll_name}"
Copy-Item -Force $json_path "C:\Applications\CQA\app\${json_name}"注意上面脚本中需要适当修改酷 Q 的路径。
本程序使用 GPLv3 许可证，并按其第 7 节添加如下附加条款：
- 本程序的修改版本应以合理的方式标志为和原版本不同的版本（附加条款 c）
总体来说，在当前许可证下，你可以：
- 修改源代码并自己使用，在不重新分发（编译之后的程序）的情况下，没有任何限制
- 不修改源代码并重新分发，对程序收费或免费提供下载，或提供其它服务，此时你需要保证在明显的地方提供本程序的源码地址并保持协议不变（包括附加条款）
- 修改源代码并重新分发，对程序收费或免费提供下载，或提供其它服务，此时你需要注明源码修改的地方、提供源码地址、保持协议不变（可删除全部或部分附加条款）、修改程序的名称
如果使用过程中遇到任何问题、Bug，或有其它意见或建议，欢迎提 issue。
也欢迎加入 QQ 交流群 201865589 来和大家讨论～
如果你觉得本插件挺好用的，不妨进行捐助～你的捐助会让我更加有动力完善插件，感谢你的支持！
这里 列出了捐助者名单，由于一些收款渠道无法知道对方是谁，如有遗漏请联系我修改。
