【QQPusher】使用一个简单的HTTP接口实现消息推送

最新推荐文章于 2025-03-31 08:47:43 发布

qq_38647058

最新推荐文章于 2025-03-31 08:47:43 发布

阅读量1w

点赞数 3

本文链接：https://blog.csdn.net/qq_38647058/article/details/110422648

版权

介绍

什么是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里面，具体参数如下：

  {
      "token":"你的token",
      "user_id":"对方 QQ 号",
      "message":"要发送的内容",
      "auto_escape":true // 默认值：false 消息内容是否作为纯文本发送（即不解析 CQ 码），只在 message 字段是字符串时有效
  }

GET接口 GET接口是对POST接口的阉割，主要是为了某些情况下调用方便，只支持对文字（message）的发送，举例：
```
  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里面，具体参数如下：

  {
      "token":"你的token",
      "group_id":"目标 群 号",
      "message":"要发送的内容",
      "auto_escape":true // 默认值：false 消息内容是否作为纯文本发送（即不解析 CQ 码），只在 message 字段是字符串时有效
  }

GET接口 GET接口是对POST接口的阉割，主要是为了某些情况下调用方便，只支持对文字（message）的发送，举例：
```
  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里面，具体参数如下：
```
  {
      "token":"你的token",
      "group_id":"目标 群 号",
      "mute":true // true 设置群禁言  false 取消群禁言
  }
```

GET接口 举例：

  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里面，具体参数如下：
```
  {
      "token":"你的token",
      "group_id":"目标 群 号",
      "group_member":群成员QQ, // 整型
      "mute_time":禁言时常 // 整型 单位秒
  }
```

GET接口 举例：

  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里面，具体参数如下：
```
  {
      "token":"你的token",
      "group_id":"目标 群 号",
      "group_name":"群名"
  }
```

GET接口 举例：

  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里面，具体参数如下：
```
  {
      "token":"你的token",
      "group_id":"目标 群 号",
      "memo":"群公告"
  }
```

GET接口 举例：

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

回调说明

群事件回调通知

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

在管理后台应用管理中填写回调地址，QQPusher会对你设置的地址发起HTTP调用，把用户所发推送给你。回调的使用POST方法，数据格式如下：

  {
      "Type":"GroupMessage", // 以后更多事件通过此字段来区分
      "Msg":{
          "Id":178,
          "InternalId":1722753991,
          "GroupCode":通知的 群 号,
          "GroupName":"通知的 群 名",
          "Sender":{
              "Uin":发送者QQ,
              "Nickname":"发送者昵称",
              "CardName":"发送者群名片",
              "IsFriend":true
          },
          "Time":1605769449,
          "Content":"这是一条演示消息" // 这里是消息内容
      }
  }

注意：避免消息被滥用,你必须是此群群主

小工具

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

解析抖音水印

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

CQ码说明

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

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

基本常用的也就这几个了

注意：图片地址不能是有防盗链的，否则会发送无效！

限制说明

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

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