介绍

什么是QQPusher

QQPusher (QQ推送服务)是一个使用QQ号作为通道的,实时信息推送平台,你可以通过调用API的方式,把信息推送到QQ上,无需安装额外的软件,即可做到息实时通知。 你可以使用QQPusher来做服务器报警通知、抢课通知、抢票通知,信息更新提示等。

demo演示程序

你可以访问演示程序,体验功能:http://qqpusher.yanxianjun.com/demo/
请一定不要调用demo程序,直接给用户发送消息!!!

视频教程: https://www.bilibili.com/video/BV1Ev411r7EL

效果预览

类型 发送普通私聊 发送群聊 发送图片
预览
图片名
图片名
图片名

快速接入

注册

http://qqpusher.yanxianjun.com/admin/ ,使用QQ扫码登录,新用户首次扫码完成注册。

发送消息

在后台右上角基础资料中获取token,后续每个api都需要将此token携带在header参数中中,然后调用发送接口发送消息!

HTTP调用

发送私聊消息 (你需要将QQPusher加为好友)

  • POST接口 POST接口是功能完整的接口,推荐使用。

    ContentType:application/json

    地址:http://api.qqpusher.yanxianjun.com/send_private_msg

    请求数据放在body里面,具体参数如下:

    1
    2
    3
    4
    5
    6
    {
    "token":"你的token",
    "user_id":"对方 QQ 号",
    "message":"要发送的内容",
    "auto_escape":true // 默认值:false 消息内容是否作为纯文本发送(即不解析 CQ 码),只在 message 字段是字符串时有效
    }
  • GET接口 GET接口是对POST接口的阉割,主要是为了某些情况下调用方便,只支持对文字(message)的发送,举例:

    1
    http://api.qqpusher.yanxianjun.com/send_private_msg?token=你的token&user_id=想要发送给的QQ&message=消息内容&auto_escape=true

    请求参数:user_id、message、auto_escape ,其中auto_escape可省略。

发送群消息 (你需要将QQPusher拉入群中)

  • POST接口 POST接口是功能完整的接口,推荐使用。

    ContentType:application/json

    地址:http://api.qqpusher.yanxianjun.com/send_group_msg

    请求数据放在body里面,具体参数如下:

    1
    2
    3
    4
    5
    6
    {
    "token":"你的token",
    "group_id":"目标 群 号",
    "message":"要发送的内容",
    "auto_escape":true // 默认值:false 消息内容是否作为纯文本发送(即不解析 CQ 码),只在 message 字段是字符串时有效
    }
  • GET接口 GET接口是对POST接口的阉割,主要是为了某些情况下调用方便,只支持对文字(message)的发送,举例:

    1
    http://api.qqpusher.yanxianjun.com/send_group_msg?token=你的token&group_id=目标 群 号&message=消息内容&auto_escape=true

    请求参数:group_id、message、auto_escape ,其中auto_escape可省略。

设置群操作 (你需要将QQPusher设为群管理员)

禁言全部

  • POST接口 POST接口是功能完整的接口,推荐使用。

    ContentType:application/json

    地址:http://api.qqpusher.yanxianjun.com/set_group_mute_all

    请求数据放在body里面,具体参数如下:

    1
    2
    3
    4
    5
    {
    "token":"你的token",
    "group_id":"目标 群 号",
    "mute":true // true 设置群禁言 false 取消群禁言
    }
  • GET接口 举例:

    1
    http://api.qqpusher.yanxianjun.com/set_group_mute_all?token=你的token&group_id=目标 群 号&mute=true

禁言单个成员

  • POST接口 POST接口是功能完整的接口,推荐使用。

    ContentType:application/json

    地址:http://api.qqpusher.yanxianjun.com/set_group_mute

    请求数据放在body里面,具体参数如下:

    1
    2
    3
    4
    5
    6
    {
    "token":"你的token",
    "group_id":"目标 群 号",
    "group_member":群成员QQ, // 整型
    "mute_time":禁言时常 // 整型 单位秒
    }
  • GET接口 举例:

    1
    http://api.qqpusher.yanxianjun.com/set_group_mute_all?token=你的token&group_id=目标 群 号&group_id=群成员QQ&mute_time=60

设置群名

  • POST接口 POST接口是功能完整的接口,推荐使用。

    ContentType:application/json

    地址:http://api.qqpusher.yanxianjun.com/set_group_name

    请求数据放在body里面,具体参数如下:

    1
    2
    3
    4
    5
    {
    "token":"你的token",
    "group_id":"目标 群 号",
    "group_name":"群名"
    }
  • GET接口 举例:

    1
    http://api.qqpusher.yanxianjun.com/set_group_mute_all?token=你的token&group_id=目标 群 号&group_name=群名

设置群公告

  • POST接口 POST接口是功能完整的接口,推荐使用。

    ContentType:application/json

    地址:http://api.qqpusher.yanxianjun.com/set_group_memo

    请求数据放在body里面,具体参数如下:

    1
    2
    3
    4
    5
    {
    "token":"你的token",
    "group_id":"目标 群 号",
    "memo":"群公告"
    }
  • GET接口 举例:

    1
    http://api.qqpusher.yanxianjun.com/set_group_mute_all?token=你的token&group_id=目标 群 号&memo=群名群公告

回调说明

群事件回调通知

当群成员发送消息到群内的时候,QQPusher会将消息推送给你。你可以搭配其他API进行自己的业务需求,比如与QQPusher对话问答,检测群成员是否触发了违规词语等。

  • 在管理后台应用管理中填写回调地址,QQPusher会对你设置的地址发起HTTP调用,把用户所发推送给你。 回调的使用POST方法,数据格式如下:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    {
    "Type":"GroupMessage", // 以后更多事件通过此字段来区分
    "Msg":{
    "Id":178,
    "InternalId":1722753991,
    "GroupCode":通知的 群 号,
    "GroupName":"通知的 群 名",
    "Sender":{
    "Uin":发送者QQ,
    "Nickname":"发送者昵称",
    "CardName":"发送者群名片",
    "IsFriend":true
    },
    "Time":1605769449,
    "Content":"这是一条演示消息" // 这里是消息内容
    }
    }
    注意:避免消息被滥用,你必须是此群群主

小工具

大家有其他有意思的api,可以在下发联系方式加群来联系我哦~

解析抖音水印

私聊QQPusher发送 解析抖音水印:这里放抖音的视频链接 即可收到解析过后的无水印链接

CQ码说明

字符串格式是 CKYU 原生所使用的消息格式,在本标准中将继续使用以保持兼容。在字符串格式中,无论纯文本还是图片、表情、链接分享等多媒体内容都放在同一个字符串里,即,一条消息对应一个字符串。以下是一个字符串格式消息的例子:

1
2
[CQ:face,id=178]消息文本[CQ:image,url=图片地址]
[CQ:at,qq=QQ号]消息文本

基本常用的也就这几个了

注意:图片地址不能是有防盗链的,否则会发送无效!

限制说明

QQPusher是免费的推送服务,为了能更好的服务大家,这里说明一下系统相关数据限制

  • 消息发送频率没有做限制,但是请控制在合理范围内。不排除后期做频率限制的可能,但是这样做也是为了更好的体验,只要在合理范围内,不会受到影响;
  • 消息发送,必须合法合规,发送违规违法欺诈等等非正常消息,可能被封号;
  • QQPusher推送的是实时消息,时效性比较强,过期以后消息也就没有价值了,目前QQPusher会为你保留7天的数据 ,7天以后不再提供可靠性保证,会不定时清理历史消息;
  • 单条消息的数据长度(字符数)限制是:message<40000;

联系方式

如果你有好的建议或者想一起打造更好的QQPusher,欢迎加入
交流群:142354175

打赏

您的支持是我更新的动力

图片名
图片名