all-pusher-api

统一化推送服务Nodejs API. 已支持钉钉, Discord, 邮件, 飞书, PushDeer, PushPlus, QQ, QQ 频道机器人, Server 酱, Showdoc Push, Telegram Bot, 企业微信群机器人, 息知, WxPusher, iGot, Chanify, Bark, Push, Slack, Pushback, Zulip, RocketChat等平台.

！！！！！仅推送！！！！！不交互！！！！！！

已支持平台

QQ(go-cqhttp) -- GoCqhttp
~~QQ(Qmsg) -- Qmsg~~
~~QQ 频道机器人 -- QqChannel~~
QQ 官方机器人 -- QQBot(主动推送能力差)
钉钉群机器人 -- DingTalk
Discord -- Discord
邮件 -- Mail
飞书群机器人 -- FeiShu
企业微信 -- WorkWeixin
企业微信群机器人 -- WorkWeixinBot
Telegram Bot -- TelegramBot
PushDeer -- PushDeer
PushPlus -- PushPlus
Server 酱 -- ServerChanTurbo
Showdoc Push -- Showdoc
息知 -- Xizhi
WxPusher -- WxPusher
~~NowPush -- NowPush~~
iGot -- IGot
Chanify -- Chanify
Bark -- Bark
GoogleChat -- GoogleChat
Push -- Push
Slack -- Slack
Pushback -- Pushback
Zulip -- Zulip
RocketChat -- RocketChat
~~Gitter -- Gitter~~
Pushover -- Pushover
爱语飞飞 -- Iyuu
Ntfy -- Ntfy
一封传话 -- YiFengChuanHua
WPush -- WPush
PushBullet -- PushBullet
SimplePush -- SimplePush
~~AnPush -- AnPush~~
PushMe -- PushMe

安装

npm install all-pusher-api -S

使用

Example

多平台推送

点击展开

const { PushApi } = require('all-pusher-api'); // 多平台同时推送

(async () => {
  console.log((await new PushApi([
    {
      name: 'ServerChanTurbo',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'PushDeer',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'WxPusher',
      config: {
        key: {
          token: '******',
          uids: ['******']
        }
      }
    },
    {
      name: 'PushPlus',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'Showdoc',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'Xizhi',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'QQBot',
      config: {
        key: {
          appId: '******',
          appSecret: '******'
        },
        userId: '******'
      }
    },
    {
      name: 'WorkWeixin',
      config: {
        corpid: '******',
        secret: '******',
        agentid: ******,
        touser: '******'
      }
    },
    {
      name: 'Mail',
      config: {
        key: {
          host: '******',
          port: 465,
          secure: true,
          auth: {
            user: '******',
            pass: '******'
          }
        },
        options: {
          from: '******',
          to: '******'
        }
      }
    },
    {
      name: 'TelegramBot',
      config: {
        token: '******',
        chat_id: '******'
      }
    },
    {
      name: 'DingTalk',
      config: {
        key: {
          token: '******',
          secret: '******'
        }
      }
    },
    {
      name: 'FeiShu',
      config: {
        key: {
          token: '******',
          secret: '******'
        }
      }
    },
    {
      name: 'Discord',
      config: {
        webhook: '******',
        proxy: {
          enable: true,
          host: '127.0.0.1',
          port: 1080
        }
      }
    },
    {
      name: 'GoCqhttp',
      config: {
        key: {
          token: '******',
          baseUrl: 'http://127.0.0.1:5700',
          user_id: '******'
        }
      }
    },
    {
      name: 'NowPush',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'IGot',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'WorkWeixinBot',
      config: {
        key: {
          webhook: '******'
        }
      }
    },
    {
      name: 'Chanify',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'Bark',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'GoogleChat',
      config: {
        key: {
          webhook: '******'
        },
        proxy: {
          enable: true,
          host: '127.0.0.1',
          port: 1080
        }
      }
    },
    {
      name: 'Push',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'Slack',
      config: {
        key: {
          webhook: '******'
        }
      }
    },
    {
      name: 'Pushback',
      config: {
        key: {
          token: 'at_******',
          userId: 'User_****'
        }
      }
    },
    {
      name: 'Zulip',
      config: {
        key: {
          token: '******',
          email: '******',
          domain: '******',
          to: '["******""]'
        }
      }
    },
    {
      name: 'RocketChat',
      config: {
        key: {
          webhook: '******'
        }
      }
    },
    {
      name: 'Pushover',
      config: {
        key: {
          token: '******',
          user: '******'
        }
      }
    },
    {
      name: 'Iyuu',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'Ntfy',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'YiFengChuanHua',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'WPush',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'PushBullet',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'SimplePush',
      config: {
        key: {
          token: '******'
        }
      }
    },
    {
      name: 'PushMe',
      config: {
        key: {
          token: '******'
        }
      }
    }
  ])
    .send({ message: '测试文本' })).map((e) => (e.result.status >= 200 && e.result.status < 300) ? `${e.name} 测试成功` : e));
})();

单平台推送

(async () => {
  // Example 1
  const { PushApi } = require('all-pusher-api'); // 多平台同时推送

  const result = await new PushApi([
    {
      name: 'ServerChanTurbo',
      config: {
        key: {
          token: '******'
        }
      }
    }
  ])
    .send({ message: '测试文本' });
  console.log(result.map((e) => (e.result.status >= 200 && e.result.status < 300) ? `${e.name} 测试成功` : e));

  // Example 2
  const { WxPusher } = require('all-pusher-api/dist/WxPusher'); // 单平台推送可选

  const wxPusherResult = await new WxPusher({
    token: '******',
    uids: ['******']
  })
    .send({ message: '测试文本' });
  console.log(wxPusherResult);
})();

extraOptions

(async () => {
  const { DingTalk } = require('all-pusher-api/dist/DingTalk');

  const result = await new DingTalk({
    key: {
      token: '******',
      secret: '******'
    }
  })
    .send({
      message: '这条消息@了所有人',
      extraOptions: {
        isAtAll: true
      }
    });
  console.log(result);
})();

customOptions

这里以钉钉为例

(async () => {
  const { DingTalk } = require('all-pusher-api/dist/DingTalk');

  const result = await new DingTalk({
    key: {
      token: '******',
      secret: '******'
    }
  })
    .send({
      customOptions: {
        "msgtype": "actionCard",
        "actionCard": {
          "title": "我 20 年前想打造一间苹果咖啡厅, 而它正是 Apple Store 的前身",
          "text": "![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png) \n\n #### 乔布斯 20 年前想打造的苹果咖啡厅 \n\n Apple Store 的设计正从原来满满的科技感走向生活化, 而其生活化的走向其实可以追溯到 20 年前苹果一个建立咖啡馆的计划",
          "btnOrientation": "0",
          "btns": [
            {
                "title": "内容不错",
                "actionURL": "https://www.dingtalk.com/"
            },
            {
                "title": "不感兴趣",
                "actionURL": "https://www.dingtalk.com/"
            }
          ]
        }
      }
    });
  console.log(result);
})();

自定义接口

(async () => {
  const { Custom } = require('all-pusher-api/dist/Custom'); // 自定义接口只能通过此方法引入
  const { createHmac } = require('crypto');
 const sign = () => {
    const timestamp = new Date().getTime();
    const secret = '******';
    const stringToSign = `${timestamp}\n${secret}`;
    const hash = createHmac('sha256', secret)
      .update(stringToSign, 'utf8')
      .digest();
    return `timestamp=${timestamp}&sign=${encodeURIComponent(hash.toString('base64'))}`;
  };
  console.log(await new Custom({
    url: `https://oapi.dingtalk.com/robot/send?access_token=******&${sign()}`,
    success: {
      key: 'responseData.errcode',
      value: 0
    }
  }).send({
    msgtype: 'text',
    text: {
      content: '测试文本'
    }
  }));
  /* 返回值
  {
    status: 200,
    statusText: 'Success',
    extraMessage: <AxiosResponse>
  }
  */
});

命令行使用

全局安装

npm install all-pusher-api -g

快速使用

allpush send -m '测试文本' -c '{\"name\":\"ServerChanTurbo\",\"config\":{\"key\":{\"token\":\"******\"}}}'
allpush send -m '测试文本' -f './config.json'

allpush send -h

# Usage: allpush send [options]
#
# 向配置的推送平台发送消息
#
# Options:
#   -c, --config <config>     JSON 配置字符串，需对引号进行转义。在线生成: https://configer.hclonely.com/?fileLink=https://raw.githubusercontent.com/HCLonely/all-pusher-api/main/config/template.yaml.js
#   -f, --config-file <path>  JSON 配置文件路径。在线生成: https://configer.hclonely.com/?fileLink=https://raw.githubusercontent.com/HCLonely/all-pusher-api/main/config/template.yaml.js
#   -m, --message <text>      要发送的消息内容
#   -t, --title <text>        消息标题
#   -h, --help                显示帮助信息

使用-c选项时JSON字符串要压缩为单行，双引号要转义！使用多个通道同时推送时建议使用-f选项而不是-c选项！

QQ 机器人事件监听

主要用于获取QQ用户/群/频道的openid

# 监听所有事件（默认）
allpush listen --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

# 监听指定事件类型
allpush listen --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET --intents PUBLIC_GUILD_MESSAGES,GUILDS

# 查看可用事件类型
allpush listen --list-intents

# 分片监听（适合大规模事件）
allpush listen --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET --shard 0,4

参数	类型	默认值	说明
`--app-id`	`string`	必填	QQ 机器人 AppID
`--app-secret`	`string`	必填	QQ 机器人 AppSecret
`--intents`	`string`	全部事件	订阅事件类型，逗号分隔
`--shard`	`string`	`0,1`	分片参数，格式: index,total
`--list-intents`	-	-	列出所有可用事件类型

可用事件类型：

名称	位值	说明
GUILDS	1 << 0	频道事件（创建/更新/删除/退出）
GUILD_MEMBERS	1 << 1	成员事件（加入/更新/移除）
GUILD_MESSAGES	1 << 9	私域消息事件
GUILD_MESSAGE_REACTIONS	1 << 10	消息表情表态事件
DIRECT_MESSAGE	1 << 12	频道私信事件
GROUP_AND_C2C_EVENT	1 << 25	群聊和单聊事件
INTERACTION	1 << 26	互动事件
MESSAGE_AUDIT	1 << 27	消息审核事件
FORUMS_EVENT	1 << 28	论坛事件
AUDIO_ACTION	1 << 29	音频事件
PUBLIC_GUILD_MESSAGES	1 << 30	公域消息事件（含 at 机器人消息）

注意：除 GUILDS、GUILD_MEMBERS、PUBLIC_GUILD_MESSAGES 为基础权限外，其他事件类型需在 QQ 开放平台申请权限后才能订阅。订阅无权限的事件会导致 WebSocket 连接被关闭。

参数

pusherConfig

const pusher = new WxPusher(pusherConfig);

参数生成器

参数	类型	默认值	说明
`token`	`string`	`null`	大部分平台的授权token, 如果有授权信息有多个, 请使用`key`
`baseUrl`	`string`	`null`	对于部分支持搭建服务端的平台, 如果使用自建服务端, 需配置此选项
`webhook`	`string`	`null`	`Discord`, `企业微信机器人`, `RocketChat`和`GoogleChat` 的 webhook 地址, 该平台请使用`webhook`而不是`token`
`userId`	`string`	`null`	`Pushback` 平台的 User_id
`chat_id`	`string`	`null`	`Telegram` 平台的 chat_id
`email`	`string`	`null`	`Zulip` 平台的 bot email
`domain`	`string`	`null`	`Zulip` 平台的 domain
`to`	`Array<number\|string>`	`null`	`Zulip` 平台的发送对象
`roomId`	`string`	`null`	`Gitter` 平台发送对象的 roomid
`baseUrl`	`string`	`null`	go-cqhttp 的http通信地址, 以`http://`或`https://`开头
`user_id`	`number`	`null`	使用 go-cqhttp 推送时的目标 QQ 号, 此参数与`group_id`, `channel_id`二选一
`group_id`	`number`	`null`	使用 go-cqhttp 推送时的目标群号, 此参数与`user_id`, `channel_id`二选一
`channel_id`	`string`	`null`	使用 go-cqhttp 推送时的目标频道ID, 此参数与`user_id`, `group_id`二选一, 且必须与`guild_id`同时存在
`guild_id`	`string`	`null`	使用 go-cqhttp 推送时的目标子频道ID, 此参数必须与`channel_id`同时存在
`corpid`	`string`	`null`	企业微信群机器人的corpid
`agentid`	`string`	`null`	企业微信群机器人的agentid
`secret`	`string`	`null`	钉钉、飞书加签的密钥[可选]/企业微信群机器人的secret
`touser`	`string`	`null`	企业微信群机器人指定接收消息的成员, 也可在sendOptions中配置
`uids`	`Array<string>`	`null`	WxPusher 发送目标的 UID, 也可在sendOptions中配置
`topicIds`	`Array<number>`	`null`	WxPusher 发送目标的 topicId, 也可在sendOptions中配置
`appId`	`string`	`null`	QQ机器人的 appId, 使用QQBot推送时此选项为必选
`clientSecret`	`string`	`null`	QQ机器人的 clientSecret, 使用QQBot推送时此选项为必选
`userId`	`string`	`null`	QQBot 单聊目标用户 openid, 与 `groupId`, `channelId` 三选一
`groupId`	`string`	`null`	QQBot 群聊目标群 openid, 与 `userId`, `channelId` 三选一
`channelId`	`string`	`null`	QQ频道的子频道 ID, 使用QQ频道推送时此选项为必选
`user`	`string`	`null`	Pushover 的 user key, 使用 Pushover 推送时此选项为必选
`key`	`object`	`null`	以上参数都可以放到`key`中, 示例
- `key.host`	`string`	`null`	邮件发送服务器地址, 使用邮件推送时此选项为必选
- `key.port`	`number`	`null`	邮件发送服务器端口, 使用邮件推送时此选项为必选
- `key.secure`	`boolean`	`false`	邮件发送服务器是否启用TLS/SSL, 可选
- `key.auth`	`object`	`null`	邮件发送服务器的验证信息, 使用邮件推送时此选项为必选
- `key.auth.user`	`string`	`null`	邮件发送服务器的用户名, 使用邮件推送时此选项为必选
- `key.auth.pass`	`string`	`null`	邮件发送服务器的密码, 使用邮件推送时此选项为必选
`proxy`	`object`	`null`	代理配置, 可选, 部分支持
- `proxy.enable`	`boolean`	`false`	是否启用代理
- `proxy.protocol`	`string`	`'http'`	代理协议
- `proxy.host`	`string`	`null`	代理主机地址
- `proxy.port`	`number`	`null`	代理端口
- `proxy.username`	`string`	`null`	代理用户名
- `proxy.password`	`string`	`null`	代理密码

CustomConfig

自定义接口

const customPusher = new Custom(CustomConfig);

参数	类型	默认值	说明
`url`	`string`	`null`	请求链接, 必需
`method`	`string`	`'POST'`	请求方式, 可选
`contentType`	`string`	`'application/json'`	发送的数据类型, 等同于`hreders['Content-type']`
`headers`	`AxiosRequestHeaders`	`null`	请求头, 可选
`success`	`object`	`null`	推送成功的判断方式, 必需
- `success.key`	`string`	`null`	请看示例
- `success.value`	`any`	`null`	请看示例
`key`	`object`	`null`	以上参数都可以放到key中
`proxy`	`object`	`null`	代理配置, 同上

pushersConfig

const pushers = new PushApi(pushersConfig);

const pushersConfig: Array<{
  name: string,
  config: pusherConfig
}>

sendOptions

const result = await pusher.send(sendOptions);

参数	类型	默认值	说明
`message`	`string`	`null`	推送的消息内容, `message`与`customOptions`至少要有一个
`title`	`string`	`null`	部分平台支持消息标题, 不填则自动提取`message`第一行的前10个字符
`type`	`string`	`'text'`	仅支持`text`, `markdown`, `html`. 具体平台支持情况请查看支持的消息类型
`extraOptions`	`object`	`null`	附加内容, 此对象中的内容会附加到请求体中, 示例
`customOptions`	`object`	`null`	自定义请求内容, 推送时会POST`customOptions`, 示例

customSendOptions

const result = await customPusher.send(customSendOptions);

customSendOptions会直接作为请求体发送, 具体请查看示例.

pushersSendConfig

const results = await pushers.send(pushersSendConfig);

const pushersSendConfig: Array<{
  name: string
  config: pushersSendConfig
}>

返回值

result

const result = await pusher.send(sendOptions);

参数	类型	默认值	说明
`status`	`number`	`null`	状态码
`statusText`	`string`	`null`	状态说明文本
`extraMessage`	`AxiosResponse`	`Error`	`null`

results

const results = await pushers.send(pushersSendConfig);

const results: Array<{
  name: string
  result: result
}>

支持的消息类型

所有平台支持均纯文本(text)格式消息, 大部分支持markdown格式消息, 部分支持html格式消息

markdown*为支持html格式不支持markdown格式消息时自动将markdown转换为html格式

other为部分平台支持特殊格式的消息, 可通过customOptions传入参数, 具体参数请查看相应平台的文档

Showdoc: 'text'
Pushover: 'text'
爱语飞飞: 'text'
SimplePush: 'text'
QQ(go-cqhttp): 'text', 'other'
~~Qmsg: 'text', 'other'~~
Discord: 'text', 'other'
飞书: 'text', 'other'
PushBullet: 'text', 'other'
~~NowPush: 'text', 'other'~~
Chanify: 'text', 'other'
Bark: 'text', 'other'
Server酱Turbo: 'text', 'markdown'
息知: 'text', 'markdown'
WPush: 'text', 'markdown'
AnPush: 'text', 'markdown'
PushDeer: 'text', 'markdown', 'other'
QQ官方机器人: 'text', 'markdown', 'other'
企业微信: 'text', 'markdown', 'other'
企业微信群机器人: 'text', 'markdown', 'other'
钉钉: 'text', 'markdown', 'other'
TelegramBot: 'text', 'markdown', 'html'
一封传话: 'text', 'markdown', 'html'
PushMe: 'text', 'markdown', 'html'
邮件: 'text', 'markdown*', 'html'
PushPlus: 'text', 'markdown*', 'html'
WxPusher: 'text', 'markdown*', 'html'

状态码

0-Missing Parameter: ***: 缺少必要参数
10-Missing Options: 缺少发送消息配置
11-Unknown Error: 未知错误
200-Success: 推送成功
201-Waiting: 待审核
100-Error: 请求发送成功, 服务器返回错误信息
101-No Response Data: 请求发送成功, 但没有接收到服务器返回的数据
102-Request Error: 请求发送失败, 一般是网络问题
103-Options Format Error: 参数格式错误
104-Get "***" Failed: 获取参数失败
140-Check Sign Failed: 签名校检失败

Name		Name	Last commit message	Last commit date
Latest commit History 36 Commits
.github/workflows		.github/workflows
config		config
dist		dist
src		src
test		test
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
rollup.config.mjs		rollup.config.mjs
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

all-pusher-api

已支持平台

安装

使用

Example

多平台推送

单平台推送

extraOptions

customOptions

自定义接口

命令行使用

全局安装

快速使用

QQ 机器人事件监听

参数

pusherConfig

CustomConfig

pushersConfig

sendOptions

customSendOptions

pushersSendConfig

返回值

result

results

支持的消息类型

状态码

About

Uh oh!

Releases 20

Packages

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

all-pusher-api

已支持平台

安装

使用

Example

多平台推送

单平台推送

extraOptions

customOptions

自定义接口

命令行使用

全局安装

快速使用

QQ 机器人事件监听

参数

pusherConfig

CustomConfig

pushersConfig

sendOptions

customSendOptions

pushersSendConfig

返回值

result

results

支持的消息类型

状态码

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 20

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages