smartqq

Smart QQ Java

基于 Smart QQ（Web QQ） 的 Api 封装，你可以用这个 Api 制作属于自己的 QQ 机器人！

该项目目前（2016年2月）为止还可以正常使用，我也会尽量一直维护这个项目，Ruby版也是如此。

该项目仅提供了最基本的通信协议，你可以在此基础上实现自己的业务逻辑，包括且不限于：

• 拥有 GUI 的 QQ 客户端（Android 或桌面版）
• 自动聊天回复的 QQ 机器人，比如小薇
• 汇总聊天记录并同步在云上
• 通过 QQ 写邮件、发短信、执行远程服务器的命令
• 等等……

注：由于 Smart QQ 不支持收发图片等功能，所以此 Api 也只可以发送文字消息（不包含 @ 命令）。

使用方法

如果你需要将此Api嵌入到别的项目，可以使用Maven依赖：

仓库：

    scienjus-mvn-repo
    https://raw.github.com/ScienJus/maven/snapshot/
    
        true
        always
    

依赖：

    com.scienjus
    smartqq
    1.0-SNAPSHOT

如果你只是想要尝试一下，可以直接Clone本项目并随便写个Main方法运行。

…

Api 列表

如果你想要了解 Web QQ 的通讯协议，并自己实现一个通讯接口。我在博客中详细的记录了抓包获取的请求和对应参数信息。你可以直接点击下面的目录：

Web QQ协议分析（一）：前言

Web QQ协议分析（二）：登录

Web QQ协议分析（三）：收发消息

Web QQ协议分析（四）：好友相关

Web QQ协议分析（五）：群和讨论组相关

Web QQ协议分析（六）：其他

常见错误

程序无法控制的错误

错误码103：这个是由于Smart QQ多点登录，后端校验失败。需要手动进入官网，检查是否能正常接收消息。如果可以的话点击[设置]->[退出登录]后查看是否恢复正常

正常流程不应该发生的错误

错误码100001、1000000：基本是由于参数错误或者Cookie错误所引起的，如果遇到这种情况，请提交Issue反馈

错误码6：如果是在getGroupInfo方法中出现，可能是误把group.id当成group.code作为参数了，这里的参数应该是code。

更新日志

2016-2-2：修改了Jar运行时保存二维码失败的Bug，感谢@oldjunyi的反馈！

2016-2-1：程序无法接收消息，同时登录官网后也无法接收消息。大约 15:44 左右恢复正常，程序不需要更新。感谢@WiseClock提供信息！

2016-11-3：由于很多人不知 Lombok 为何物而导致编译错误，所以去除了，真为不会使用工具的人感到悲哀！

感谢

现在使用requests进行 Http 请求

其他版本

1. @lonhay 提供了一个基于最新版 Requests 和 Java 8 的版本

2. @88250 提供了一个可以直接使用的 Web 服务，参见b3log/xiaov

3. @sjdy521 提供了一个可以通过HTTP协议api接口完成接收、发送QQ消息等功能的项目，参见Mojo-Webqq

4. @TJYSunset 提供了一个本项目的 C# 版本

联系方式

由于 Web QQ 协议变更比较频繁，而我也不可能时时都去测试 Api 的可用性，所以如果您在使用途中发现了问题，欢迎给我提 Issue ，或是通过邮件联系我：[email protected]，意见和建议也欢迎。