Pushover Message API

Pushover Message API 使用应用 Token 标识发送应用，使用 User Key 或 Group Key 标识接收方。本文依据 Pushover 官方 API 文档整理，核验日期为 2026-09-08；未使用真实账号执行推送。

准备条件

• 已注册 Pushover 账号并在设备上完成客户端登录。
• 已创建 Application/API Token。
• 已取得接收方 User Key 或 Group Key。

配置步骤

1. 在 Pushover 控制台注册一个应用。
2. 保存应用 API Token/Key。
3. 从接收账号或群组取得 User Key/Group Key。
4. 使用表单请求提交 token、user 和 message。
5. 最小消息成功后，再增加标题、优先级、声音或跳转 URL。

凭据说明

字段	必需	说明
PUSHOVER_APP_TOKEN	是	发送应用的 API Token/Key
PUSHOVER_USER_KEY	是	接收用户或群组 Key
message	是	消息正文
priority	否	优先级；紧急优先级还需要额外参数与确认流程

最小请求

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

curl

curl -X POST 'https://api.pushover.net/1/messages.json' \
  --form-string 'token=PUSHOVER_APP_TOKEN' \
  --form-string 'user=PUSHOVER_USER_KEY' \
  --form-string 'title=连通性测试' \
  --form-string 'message=通知渠道连通性测试'

JavaScript

const body = new FormData();
body.set('token', process.env.PUSHOVER_APP_TOKEN);
body.set('user', process.env.PUSHOVER_USER_KEY);
body.set('title', '连通性测试');
body.set('message', '通知渠道连通性测试');

const response = await fetch('https://api.pushover.net/1/messages.json', {
  method: 'POST',
  body,
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

Python

import os
import requests

response = requests.post(
    "https://api.pushover.net/1/messages.json",
    data={
        "token": os.environ["PUSHOVER_APP_TOKEN"],
        "user": os.environ["PUSHOVER_USER_KEY"],
        "title": "连通性测试",
        "message": "通知渠道连通性测试",
    },
    timeout=15,
)
response.raise_for_status()
print(response.json())

验证结果

检查响应中的 status 和请求标识，并在目标设备确认收到消息。紧急优先级需要额外验证用户确认和重试状态。

安全建议

• 应用 Token 和 User Key 都只在服务端保存。
• 不把紧急优先级用于普通告警，避免重复打扰和额外配额消耗。
• 为不同应用创建独立 Token，便于撤销和配额追踪。

常见问题

token is invalid：确认使用应用 API Token，而不是用户 Key。

user identifier is not a valid user：检查 User Key/Group Key 是否完整。

紧急消息参数错误：紧急优先级需要符合官方要求的 retry 和 expire 参数。

官方资料

• Pushover：Message API