什么时候用
你使用的工具已经支持 Webhook,或者脚本能发送 HTTPS 请求。从 Ntfyx 复制发送链接,即可接入这些工具。GET 使用链接里的消息,POST 则向同一个固定地址发送新的文本或 JSON。
三步接好
准备 HTTPS 推送
在手机打开 HTTPS 推送,先使用 App 内“发送”测试连接。
复制专属发送地址
将完整 URL 保存到脚本的私有配置或服务的 Webhook 设置中。
发送并检查收件箱
访问链接发送其中的消息,或向它 POST 文本、JSON,再在手机核对对应消息。
怎样确认接通了
先在本机将 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 重试。