all-pusher-api

Appearance

推送服务 ​

本页按服务分别说明配置。所有服务都可以通过 PushApi 的 name + config 使用，也可以直接从 all-pusher-api/dist/<ClassName> 引入对应类。

除特殊说明外：

  • 认证信息推荐放入 config.key。
  • message 与 customOptions 至少提供一个。
  • extraOptions 会合并进默认请求体。
  • customOptions 会直接作为该平台请求体。
  • 支持 proxy 的服务都使用 统一代理配置。

Bark ​

类名：Bark

官方 API 文档：Bark

配置项必填说明
key.token是Bark device key。
key.baseURL否自建服务端地址，默认为 https://api.day.app/push。
js
const { Bark } = require('all-pusher-api/dist/Bark');

await new Bark({
  key: {
    token: '******',
    baseURL: 'https://api.day.app/push'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text，也可通过 customOptions 发送 Bark 支持的完整请求体。

默认请求体会生成 { title, body, device_key }。title 未提供时取正文首行前 10 个字符。

Chanify ​

类名：Chanify

官方 API 文档：Chanify

配置项必填说明
key.token是Chanify token。
key.baseURL否自建服务端地址，默认为 https://api.chanify.net/v1/sender/。
js
const { Chanify } = require('all-pusher-api/dist/Chanify');

await new Chanify({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text，也可通过 customOptions 发送平台自定义字段。

默认请求体会生成 { title, text }，并以表单格式发送到 baseURL + token。

DingTalk ​

类名：DingTalk

官方 API 文档：钉钉群机器人

配置项必填说明
key.token是钉钉群机器人 access_token。
key.secret否开启加签时填写加签密钥。
js
const { DingTalk } = require('all-pusher-api/dist/DingTalk');

await new DingTalk({
  key: {
    token: '******',
    secret: '******'
  }
}).send({
  message: '### 发布完成',
  type: 'markdown',
  extraOptions: {
    at: {
      isAtAll: true
    }
  }
});

支持类型：text、markdown、other。other 通过 customOptions 发送。

Discord ​

类名：Discord

官方 API 文档：Discord Webhook

配置项必填说明
key.webhook是Discord Webhook URL。
js
const { Discord } = require('all-pusher-api/dist/Discord');

await new Discord({
  key: {
    webhook: 'https://discord.com/api/webhooks/******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、other。默认请求体为 { content }，如果传入 title 会拼接到正文前。

FeiShu ​

类名：FeiShu

官方 API 文档：飞书群机器人

配置项必填说明
key.token是飞书群机器人 hook token。
key.secret否开启签名校验时填写密钥。
js
const { FeiShu } = require('all-pusher-api/dist/FeiShu');

await new FeiShu({
  key: {
    token: '******',
    secret: '******'
  }
}).send({
  message: '测试文本'
});

支持类型：text、other。默认请求体为飞书文本消息：{ msg_type: 'text', content: { text } }。

GoCqhttp ​

类名：GoCqhttp

官方 API 文档：QQ go-cqhttp

配置项必填说明
key.baseUrl是go-cqhttp HTTP API 地址，需包含 http:// 或 https://。
key.token否go-cqhttp access token。
key.user_id否目标 QQ 号，与 group_id、channel_id 三选一。
key.group_id否目标群号，与 user_id、channel_id 三选一。
key.channel_id否目标频道 ID，需与 guild_id 同时存在。
key.guild_id否目标子频道 ID，需与 channel_id 同时存在。
js
const { GoCqhttp } = require('all-pusher-api/dist/GoCqhttp');

await new GoCqhttp({
  key: {
    baseUrl: 'http://127.0.0.1:5700',
    token: '******',
    user_id: 10000
  }
}).send({
  message: '测试文本'
});

支持类型：text、other。频道消息会发送到 /send_guild_channel_msg，其他消息发送到 /send_msg。

GoogleChat ​

类名：GoogleChat

官方 API 文档：Google Chat Webhook

配置项必填说明
key.webhook是Google Chat Webhook URL。
js
const { GoogleChat } = require('all-pusher-api/dist/GoogleChat');

await new GoogleChat({
  key: {
    webhook: 'https://chat.googleapis.com/v1/spaces/******'
  }
}).send({
  message: '测试文本'
});

支持类型：text、other。默认请求体为 { text: message }。

IGot ​

类名：IGot

官方 API 文档：iGot

配置项必填说明
key.token是iGot 推送 key。
js
const { IGot } = require('all-pusher-api/dist/IGot');

await new IGot({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、other。默认请求体包含标题和内容。

Iyuu ​

类名：Iyuu

官方 API 文档：爱语飞飞

配置项必填说明
key.token是IYUU 令牌。
js
const { Iyuu } = require('all-pusher-api/dist/Iyuu');

await new Iyuu({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text。默认使用标题和正文发送。

Mail ​

类名：Mail

官方 API 文档：Nodemailer

配置项必填说明
key.host是SMTP 服务器地址。
key.port是SMTP 服务器端口。
key.secure否是否启用 TLS/SSL。
key.auth.user是SMTP 用户名。
key.auth.pass是SMTP 密码。
options.from是发件人邮箱。
options.to否收件人邮箱，也可通过 extraOptions.to 覆盖。
js
const { Mail } = require('all-pusher-api/dist/Mail');

await new Mail({
  key: {
    host: 'smtp.example.com',
    port: 465,
    secure: true,
    auth: {
      user: 'sender@example.com',
      pass: 'password'
    }
  },
  options: {
    from: 'sender@example.com',
    to: 'receiver@example.com'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、markdown、html。markdown 会转换为 HTML 发送。

NotifyX ​

类名：NotifyX，PushApi 的平台名称不区分大小写。

官方 API 文档：码达 (NotifyX)

配置项必填说明
key.token是NotifyX 控制台生成的 API 密钥，也可使用顶层 token。
proxy否统一代理配置。
js
const { NotifyX } = require('all-pusher-api/dist/NotifyX');

await new NotifyX({ key: { token: '******' } }).send({
  title: '发布完成',
  message: '## 更新内容\n新版本已部署。',
  type: 'markdown',
  extraOptions: {
    description: '版本更新通知',
    team: '1234567890'
  }
});

通过统一 API 或 CLI 使用时，配置为 { "name": "NotifyX", "config": { "key": { "token": "******" } } }。

默认以 JSON POST 请求 https://www.notifyx.cn/api/v1/send/:key，将 message 映射为 content。未提供 title 时取正文首行去除两端空白后的前 10 个字符。正文支持文本和 Markdown，type 不会作为接口参数发送。

extraOptions 可设置 description、team 或覆盖默认字段；customOptions 可提供完整请求体（包含必填的 title 和 content），之后仍会合并 extraOptions。

平台字段长度上限：title 100 字符、content 2000 字符、description 500 字符、team 32 字符。请按这些限制提供内容。

响应 status: "queued" 映射为统一结果 status: 200，仅表示消息已加入队列；原始响应保留在 extraMessage 中。

Ntfy ​

类名：Ntfy

官方 API 文档：Ntfy Publish

配置项必填说明
key.token是ntfy topic。
key.baseURL否自建服务端地址，默认使用 ntfy 官方服务。
js
const { Ntfy } = require('all-pusher-api/dist/Ntfy');

await new Ntfy({
  key: {
    token: 'mytopic',
    baseURL: 'https://ntfy.sh/'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、other。默认以正文作为消息内容，标题可通过 title 传入。

Push ​

类名：Push

官方 API 文档：Push

配置项必填说明
key.token是Push API key。
key.baseURL否自定义接口地址。
js
const { Push } = require('all-pusher-api/dist/Push');

await new Push({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、other。

Pushback ​

类名：Pushback

官方 API 文档：Pushback

配置项必填说明
key.token是at_token。
key.userId是Pushback User_id。
js
const { Pushback } = require('all-pusher-api/dist/Pushback');

await new Pushback({
  key: {
    token: 'at_******',
    userId: 'User_******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text。默认把 title 和 message 组合为 Pushback 请求。

PushBullet ​

类名：PushBullet

官方 API 文档：PushBullet

配置项必填说明
key.token是PushBullet access token。
js
const { PushBullet } = require('all-pusher-api/dist/PushBullet');

await new PushBullet({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、other。默认发送 note 类型消息。

PushDeer ​

类名：PushDeer

官方 API 文档：PushDeer

配置项必填说明
key.token是PushDeer pushkey。
key.baseURL否自建服务端地址。
js
const { PushDeer } = require('all-pusher-api/dist/PushDeer');

await new PushDeer({
  key: {
    token: '******'
  }
}).send({
  message: '### 测试文本',
  type: 'markdown'
});

支持类型：text、markdown、other。默认请求体包含 pushkey、text、desp、type。

PushMe ​

类名：PushMe

官方 API 文档：PushMe

配置项必填说明
key.token是PushMe push_key。
key.baseURL否自建服务端地址。
js
const { PushMe } = require('all-pusher-api/dist/PushMe');

await new PushMe({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、markdown、html。

Pushover ​

类名：Pushover

官方 API 文档：Pushover

配置项必填说明
key.token是Pushover API token。
key.user是Pushover user key。
js
const { Pushover } = require('all-pusher-api/dist/Pushover');

await new Pushover({
  key: {
    token: '******',
    user: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text。传入 markdown 时会启用 Pushover 的 monospace/HTML 相关字段，复杂内容建议使用 customOptions。

PushPlus ​

类名：PushPlus

官方 API 文档：PushPlus

配置项必填说明
key.token是PushPlus token。
js
const { PushPlus } = require('all-pusher-api/dist/PushPlus');

await new PushPlus({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '<h1>测试文本</h1>',
  type: 'html'
});

支持类型：text、markdown、html。默认请求体包含 token、title、content、template。

Qmsg ​

类名：Qmsg，PushApi 和 CLI 使用名称 Qmsg（不区分大小写）。

官方 API 文档：Qmsg v3

配置项必填说明
key.token是控制台获取的 API Key，需先完成机器人好友绑定。
key.group否目标 QQ 群号字符串，需先在控制台添加并绑定群；省略时发送到绑定的单聊。
proxy否统一代理配置。

token 和 group 也可放在配置顶层，key 中的同名配置优先。

js
const { Qmsg } = require('all-pusher-api/dist/Qmsg');

const pusher = new Qmsg({ key: { token: 'YOUR_API_KEY' } });
await pusher.send({ message: '任务完成' });
// 群推送也可通过 key.group 设置默认目标。
await pusher.send({ message: '任务完成', extraOptions: { group: '123456789' } });

CLI 配置文件示例：

json
[{ "name": "Qmsg", "config": { "key": { "token": "YOUR_API_KEY", "group": "123456789" } } }]

支持类型：text。使用 POST https://qmsg.zendee.cn/v3/jsend/{key}，JSON 请求体为 { msg, group? }。有标题时以换行拼接到正文前。最终消息不能为空或超过 1000 个字符（包含标题和换行），超长返回 103，不自动截断或拆分。

extraOptions 可以覆盖 msg 和 group。customOptions 完全替换默认请求体（也不继承配置中的群号），例如 { msg: '任务完成', group: '123456789' }；之后仍会合并 extraOptions。

根据响应的 success === true 返回 200，表示请求已受理，实际投递为异步处理；消息 ID 在 result.extraMessage.data.data。本适配器不自动轮询状态或重试。普通服务同一 Key 每 5 秒最多提交一次、每日最多 500 次，调用方需控制频率。

QQBot ​

类名：QQBot

官方 API 文档：QQ 官方机器人

配置项必填说明
key.appId是QQ 官方机器人 AppID。
key.appSecret是QQ 官方机器人 AppSecret。
key.userId否单聊目标用户 openid。
key.groupId否群聊目标群 openid。
key.channelId否频道子频道 ID。
key.baseUrl否QQ Bot API 地址，默认 https://api.bot.qq.com，通常无需修改。
js
const { QQBot } = require('all-pusher-api/dist/QQBot');

await new QQBot({
  key: {
    appId: '******',
    appSecret: '******',
    userId: '******'
  }
}).send({
  message: '测试文本'
});

userId、groupId、channelId 至少提供一个，也可以在发送时通过 extraOptions 或 customOptions 指定。

支持类型：text、markdown、other。QQ 官方机器人主动推送能力受平台权限限制。

单聊的 userId 请使用当前机器人收到的 C2C_MESSAGE_CREATE 事件中的 d.author.user_openid，参见官方单聊事件文档。不要使用 QQ 号、群成员 ID 或其他机器人的用户标识。

请求失败时，statusText 会包含 QQ 返回的业务错误码及描述；完整响应体可从 extraMessage.response.data 获取。例如 HTTP 400、code=11255、err_code=40011028 表示服务端返回“请求的资源不存在(用户/群已注销)”，应核对目标 OpenID 和机器人，而不是反复刷新 Access Token。

RocketChat ​

类名：RocketChat

官方 API 文档：RocketChat Incoming Webhook

配置项必填说明
key.webhook是RocketChat Incoming Webhook URL。
js
const { RocketChat } = require('all-pusher-api/dist/RocketChat');

await new RocketChat({
  key: {
    webhook: 'https://chat.example.com/hooks/******'
  }
}).send({
  message: '测试文本'
});

支持类型：text、other。默认请求体为 { text: message }。

ServerChanTurbo ​

类名：ServerChanTurbo

别名：ServerChan

官方 API 文档：Server 酱

配置项必填说明
key.token是Server 酱 SendKey。
js
const { ServerChanTurbo } = require('all-pusher-api/dist/ServerChanTurbo');

await new ServerChanTurbo({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、markdown。默认请求体包含 title 和 desp。

Showdoc ​

类名：Showdoc

官方 API 文档：Showdoc Push

配置项必填说明
key.token是Showdoc Push URL 中 /server/api/push/ 后面的 token。
js
const { Showdoc } = require('all-pusher-api/dist/Showdoc');

await new Showdoc({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text。默认请求体包含标题和内容。

SimplePush ​

类名：SimplePush

官方 API 文档：SimplePush

配置项必填说明
key.token是SimplePush key。
js
const { SimplePush } = require('all-pusher-api/dist/SimplePush');

await new SimplePush({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text。默认发送标题和正文。

Slack ​

类名：Slack

官方 API 文档：Slack Incoming Webhook

配置项必填说明
key.webhook是Slack Incoming Webhook URL。
js
const { Slack } = require('all-pusher-api/dist/Slack');

await new Slack({
  key: {
    webhook: 'https://hooks.slack.com/services/******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、other。默认请求体为 { text }，标题会拼接到正文前。

TelegramBot ​

类名：TelegramBot

官方 API 文档：Telegram Bot sendMessage

配置项必填说明
key.token是Telegram Bot token。
key.chat_id是目标 chat id。
js
const { TelegramBot } = require('all-pusher-api/dist/TelegramBot');

await new TelegramBot({
  key: {
    token: '******',
    chat_id: '******'
  }
}).send({
  message: '<b>测试文本</b>',
  type: 'html'
});

支持类型：text、markdown、html。markdown 和 html 会映射为 Telegram parse_mode。

WorkWeixin ​

类名：WorkWeixin

官方 API 文档：企业微信

配置项必填说明
key.corpid是企业 ID。
key.secret是企业应用 secret。
key.agentid是企业应用 agentid。
key.touser否接收成员，多个用 `
js
const { WorkWeixin } = require('all-pusher-api/dist/WorkWeixin');

await new WorkWeixin({
  key: {
    corpid: '******',
    secret: '******',
    agentid: 1000002,
    touser: '@all'
  }
}).send({
  message: '测试文本'
});

支持类型：text、markdown、other。touser 也可在发送时通过 extraOptions 覆盖。

WorkWeixinBot ​

类名：WorkWeixinBot

官方 API 文档：企业微信群机器人

配置项必填说明
key.webhook是企业微信群机器人 Webhook URL。
js
const { WorkWeixinBot } = require('all-pusher-api/dist/WorkWeixinBot');

await new WorkWeixinBot({
  key: {
    webhook: 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=******'
  }
}).send({
  message: '### 测试文本',
  type: 'markdown'
});

支持类型：text、markdown、other。

WPush ​

类名：WPush

官方 API 文档：WPush

配置项必填说明
key.token是WPush API token。
js
const { WPush } = require('all-pusher-api/dist/WPush');

await new WPush({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、markdown。默认请求体包含 apikey、title、content。

WxPusher ​

类名：WxPusher

官方 API 文档：WxPusher

配置项必填说明
key.token是WxPusher appToken。
key.uids否发送目标 UID 列表，也可发送时指定。
key.topicIds否发送目标 topicId 列表，也可发送时指定。
js
const { WxPusher } = require('all-pusher-api/dist/WxPusher');

await new WxPusher({
  key: {
    token: '******',
    uids: ['UID_xxx']
  }
}).send({
  title: '标题',
  message: '# Markdown 内容',
  type: 'markdown'
});

支持类型：text、markdown、html。markdown 会转换为 HTML 后以 contentType: 2 发送。

Xizhi ​

类名：Xizhi

官方 API 文档：息知

配置项必填说明
key.token是息知 key。
js
const { Xizhi } = require('all-pusher-api/dist/Xizhi');

await new Xizhi({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、markdown。默认请求体包含 title 和 content。

YiFengChuanHua ​

类名：YiFengChuanHua

官方 API 文档：一封传话

配置项必填说明
key.token是一封传话通道 code。
js
const { YiFengChuanHua } = require('all-pusher-api/dist/YiFengChuanHua');

await new YiFengChuanHua({
  key: {
    token: '******'
  }
}).send({
  title: '测试标题',
  message: '测试文本'
});

支持类型：text、markdown、html。默认请求体包含 head 和 body。

Zulip ​

类名：Zulip

官方 API 文档：Zulip send-message

配置项必填说明
key.token是Zulip bot API key。
key.email是Zulip bot email。
key.site否Zulip 站点地址，默认 https://chat.zulip.org。
key.to否发送对象。未配置时发送时必须提供。
js
const { Zulip } = require('all-pusher-api/dist/Zulip');

await new Zulip({
  key: {
    site: 'https://your-zulip.example.com',
    token: '******',
    email: 'bot@example.com',
    to: ['user@example.com']
  }
}).send({
  message: '测试文本'
});

支持类型：text。默认 type 为 direct，可通过 extraOptions.type 改为 stream 等 Zulip 支持的类型。

Custom ​

类名：Custom

Custom 不对应固定推送平台，用于把任意 HTTP 接口包装成推送服务。

官方 API 文档：自定义 HTTP 接口，无固定平台文档。

配置项必填说明
url是请求地址。
method否请求方法，默认 POST。
contentType否请求内容类型，默认 application/json。
headers否自定义请求头。
success.key是判断成功的响应字段路径，例如 responseData.errcode。
success.value是判断成功的字段值。
js
const { Custom } = require('all-pusher-api/dist/Custom');

await new Custom({
  url: 'https://example.com/push',
  success: {
    key: 'responseData.code',
    value: 0
  }
}).send({
  text: '测试文本'
});

Custom.send() 不使用统一 sendOptions，入参会直接作为请求体或查询参数发送。