工具接入 HTTPS · Webhook

用 HTTPS 把通知发到手机

用专属发送地址接入脚本和 Webhook,无需安装 CLI。

查看 HTTPS 接入方法

更新于

一条请求,把结果送到手机

MyNotify消息示例

构建完成

新版本已准备,可以查看了。

什么时候用

你使用的工具已经支持 Webhook,或者脚本能发送 HTTPS 请求。从 Ntfyx 复制发送链接,即可接入这些工具。GET 使用链接里的消息,POST 则向同一个固定地址发送新的文本或 JSON。

三步接好

  1. 准备 HTTPS 推送

    在手机打开 HTTPS 推送,先使用 App 内“发送”测试连接。

  2. 复制专属发送地址

    将完整 URL 保存到脚本的私有配置或服务的 Webhook 设置中。

  3. 发送并检查收件箱

    访问链接发送其中的消息,或向它 POST 文本、JSON,再在手机核对对应消息。

从这里开始

先在手机上准备好 Ntfyx

在电脑上?点击商店,用手机扫描二维码下载。

iPhone · 1.6.4

在手机上下载 Ntfyx

使用手机相机扫码,打开 App Store。

前往 Ntfyx 的二维码:App Store直接打开 App Store

这是商店下载链接,不会连接或授权设备。

Android · 1.6.4

在手机上下载 Ntfyx

使用手机相机扫码,打开 Google Play。

前往 Ntfyx 的二维码:Google Play直接打开 Google Play

这是商店下载链接,不会连接或授权设备。

怎样确认接通了

先在本机将 NTFYX_SEND_URL 设为 App 复制的私有链接,再运行其中一个示例。下方用于 macOS/Linux shell。接口受理只表示服务接收了请求;还应核对手机中的对应消息,系统横幅另受通知权限影响。

可复制示例
# GET:发送已复制链接中的消息
curl --fail-with-body "$NTFYX_SEND_URL"

# POST:URL 固定,正文按需修改
curl --fail-with-body "$NTFYX_SEND_URL" \
  -H 'Content-Type: application/json' \
  --data '{"text":"构建完成"}'

使用时要知道

完整 URL 含仅发送密钥,请放在私有配置中,不进入公开日志或截图。HTTPS/Webhook 内容由服务处理后再加密投递。此方式只发送通知;需要提问与回复时,使用 Agent 案例。未带幂等标识的请求每次都可能产生新消息;结果不确定时,按指南复用 Idempotency-Key 重试。