一行 HTTP 请求, 消息直达你的微信

把服务器告警、脚本运行结果、定时任务的输出,用一个请求推送到微信。不用装 App,不用注册账号,关注服务号就能用。

阅读接口文档
暖光下的草穗
一个接口接住所有通知

脚本、服务器、定时任务,都能开口说话

任何能发 HTTP 请求的地方都能接入:Shell、Python、Node、GitHub Actions、路由器、NAS。消息以微信服务通知送达,点开就是完整的 Markdown 正文。

复制一行,马上能用

GET、POST 表单、POST JSON 都支持,参数名和 Server酱 保持一致。

# 最简单的一条
curl "https://push.lemon.yun/SENDKEY.send?title=部署完成"

# 带 Markdown 正文
curl -X POST "https://push.lemon.yun/SENDKEY.send" \
  -d "title=备份结束" \
  --data-urlencode "desp=**耗时** 3 分 12 秒"
import requests

requests.post(
    "https://push.lemon.yun/SENDKEY.send",
    json={
        "title": "训练结束",
        "desp": "loss: **0.0213**\nacc: 98.4%",
    },
    timeout=10,
)
# 磁盘超过 90% 就提醒(放进 crontab)
USE=$(df / | awk 'NR==2 {print $5}' | tr -d %)
if [ "$USE" -gt 90 ]; then
  curl -s "https://push.lemon.yun/SENDKEY.send" \
    --data-urlencode "title=磁盘告警 $(hostname)" \
    --data-urlencode "desp=根分区已用 ${USE}%"
fi
返回 {"code":0} 即已送达

点开就是完整正文

通知卡片放摘要,正文用 Markdown 排版,表格、代码块、链接都能显示。

每日备份报告
  • 数据库 2.4 GB 已上传
  • 耗时 3 分 12 秒,无错误

从 Server酱 迁移,只改域名

URL 格式和参数一致,老脚本替换域名和 SendKey 就能继续用。

关注即用

关注服务号自动生成 SendKey,回复「key」随时找回,不用另外注册账号。

泄露了也不慌

SendKey 一键重置,旧的立即失效。每个 Key 有每日发送上限,被人滥用也打不爆你的微信。

每日上限 500 条 回复「重置」立即换新 详情页链接带独立密钥
薄雾中的天空
为什么是微信

告警不该埋在邮件里。脚本跑完、服务器出错、订单到账,它们应该第一时间出现在你每天打开最多的那个 App 里。

四步完成接入

从关注到收到第一条,不到一分钟

不需要服务器端 SDK,也不需要申请任何开发者权限。你只需要一个微信。

关注

扫码关注服务号

点页面上的登录按钮,用微信扫码。还没关注的话,关注后会自动登录。

拿到密钥

复制你的 SendKey

SendKey 是你专属的推送凭证。网页控制台和服务号对话里都能看到。

SKa1f3…9c07
发送

在任何地方发一个请求

把 SendKey 拼进地址,带上 title,正文放 desp。浏览器地址栏都能直接试。

/SKa1f3…9c07.send?title=你好
送达

微信里收到服务通知

通知卡片显示标题和摘要,点开查看完整的 Markdown 正文。

{"code":0,"data":{"pushid":"1024"}}
摊开的书和木桌
云雾中的山峰
日落时的海岸礁石
它适合这些时刻
凌晨三点数据库连接数飙升,手机先响,而不是第二天早上被用户投诉叫醒。
服务器监控 · 配合 cron 或 Prometheus Alertmanager webhook
跑了一整夜的模型训练结束了,loss 曲线和最终精度直接出现在对话列表里。
长任务通知 · 训练、编译、批量数据处理
家里 NAS 的硬盘出现坏道、路由器重新拨号,第一时间知道,不用每天登录后台看。
家庭设备 · NAS、软路由、智能家居自动化
1 / 3
接口文档

一个地址,三个参数

GET 和 POST 都可以。POST 支持表单和 JSON。中文请做 URL 编码,curl 用 --data-urlencode 最省事。

GET / POSThttps://push.lemon.yun/<SENDKEY>.send

请求参数

参数说明
title必填消息标题,最长 100 字。通知卡片里显示前 20 个字,兼容旧参数名 text。
desp消息正文,支持 Markdown,最长 64KB。点开通知后在详情页显示。
short通知卡片上的摘要,最长 64 字。不填就从正文自动截取。

成功返回

{
  "code": 0,
  "message": "",
  "data": { "pushid": "1024", "readkey": "…", "error": "SUCCESS", "errno": 0 }
}

错误码

40001
SendKey 无效或已重置
40002
缺少 title
40003
参数超过长度限制
40301
已取消关注服务号,重新关注后恢复
42901
超过每日发送上限
50201
微信接口返回错误,message 里有具体原因

现在就把第一条消息发给自己