PushPlus 消息推送 API

PushPlus 提供 HTTP API 接收标题和正文，再投递到账号配置的通道。本文依据 PushPlus 官方文档整理，核验日期为 2026-09-08；未使用真实 Token 执行推送。

准备条件

• 已登录 PushPlus 并取得 Token。
• 目标接收方式已在账号中完成绑定。
• 如需群组推送，已配置 Topic 并确认成员范围。

配置步骤

1. 登录 PushPlus，取得用户 Token。
2. 将 Token 存入服务器端密钥管理。
3. 先使用 txt 模板向自己发送最小消息。
4. 需要群组时增加 Topic，并先用测试群验证。
5. 再按需要选择 HTML 或 Markdown 模板。

凭据说明

字段	必需	说明
PUSHPLUS_TOKEN	是	用户发送 Token
title	是	消息标题
content	是	消息正文
template	否	内容模板，例如 txt、html、markdown
topic	群组时	群组编码

最小请求

JavaScript 示例需要 Node.js 20 或更新版本；Python 示例需要安装 requests。

curl

curl -X POST 'https://www.pushplus.plus/send' \
  -H 'Content-Type: application/json' \
  -d '{"token":"PUSHPLUS_TOKEN","title":"通知渠道连通性测试","content":"来自 PushPlus 的最小测试消息","template":"txt"}'

JavaScript

const response = await fetch('https://www.pushplus.plus/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    token: process.env.PUSHPLUS_TOKEN,
    title: '通知渠道连通性测试',
    content: '来自 PushPlus 的最小测试消息',
    template: 'txt',
  }),
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

Python

import os
import requests

response = requests.post(
    "https://www.pushplus.plus/send",
    json={
        "token": os.environ["PUSHPLUS_TOKEN"],
        "title": "通知渠道连通性测试",
        "content": "来自 PushPlus 的最小测试消息",
        "template": "txt",
    },
    timeout=15,
)
response.raise_for_status()
print(response.json())

验证结果

检查 HTTP 状态和 JSON 业务码，并确认目标客户端收到消息。群组推送还要确认实际接收成员与 Topic 配置一致。

安全建议

• Token 只在服务端使用，不拼接到可记录的浏览器 URL。
• 群组推送前检查成员范围，避免误发业务信息。
• 对接口限流做退避，不对认证或参数错误自动重试。

常见问题

Token 无效：确认 Token 没有多余空格，且属于当前账号。

模板显示异常：先回退到 txt，再检查模板名和内容格式。

群组无人接收：检查 Topic 是否存在、成员是否已加入并完成接收通道绑定。

官方资料

• PushPlus：消息推送 API