ntfy API完全手册：从基础调用到高级功能的完整指南

ntfy是一个简单、免费的HTTP推送通知服务，让你可以通过HTTP PUT/POST请求向手机或桌面发送推送通知，无需注册或支付任何费用。本指南将全面介绍ntfy API的各种功能和使用方法，帮助你充分利用这个强大的推送通知工具。

🔥 基础推送通知

ntfy的核心功能非常简单：通过HTTP请求发送消息到指定主题。主题(topic)是消息的通道，也是访问控制的关键，因此建议选择不易猜测的主题名称。

基本推送示例：

curl -d "备份成功 😀" ntfy.sh/mytopic

这行命令会向mytopic主题发送一条"备份成功 😀"的消息，所有订阅该主题的设备都会收到通知。

🎯 高级消息功能

自定义消息标题

使用Title头部字段可以覆盖默认的标题显示：

curl -H "Title: 狗狗比猫好" -d "哦天啊..." ntfy.sh/controversial

消息优先级设置

ntfy支持5种优先级，从紧急(max/5)到最低(min/1)：

curl -H "Priority: 5" -d "紧急消息" ntfy.sh/alerts

标签和表情符号

使用标签可以为消息添加表情符号和分类：

curl -H "Tags: warning,skull" -d "服务器宕机" ntfy.sh/alerts

支持的表情符号标签包括：warning ⚠️, skull 💀, +1 👍, tada 🎉 等。

📎 附件和交互功能

附加外部文件

curl -H "Attach: https://example.com/image.jpg" -d "查看这张图片" ntfy.sh/images

点击动作

设置点击通知后的跳转链接：

curl -H "Click: https://home.nest.com/" -d "有人按门铃" ntfy.sh/doorbell

动作按钮

添加交互按钮到通知中：

curl -H "Actions: http, 开门, https://api.example.com/open/door" -d "门禁请求" ntfy.sh/access

⏰ 定时发送消息

ntfy支持延迟发送消息，可以设置未来某个时间点发送：

# 30分钟后发送
curl -H "Delay: 30m" -d "记得开会" ntfy.sh/reminders

# 指定具体时间
curl -H "At: tomorrow, 3pm" -d "项目截止" ntfy.sh/deadlines

🎨 Markdown格式支持

启用Markdown格式化消息内容：

curl -H "Markdown: yes" -d "**重要**通知：请查看[文档](https://example.com)" ntfy.sh/updates

支持的功能包括：粗体、斜体、链接、图片、代码块、列表等。

📧 邮件转发

将通知同时转发到邮箱：

curl -H "Email: [e-mail]" -d "系统报警" ntfy.sh/alerts

🔐 身份验证和权限

对于需要更高安全性的场景，ntfy支持多种认证方式：

# 使用访问令牌
curl -H "Authorization: Bearer tk_AgQdq7mVBoFD37zQ7qBO" -d "私有消息" ntfy.sh/private-topic

# 基本认证
curl -u user:pass -d "认证消息" ntfy.sh/secure-topic

🌐 多语言客户端支持

ntfy提供多种客户端选择：

• Android应用：Google Play和F-Droid均可下载
• iOS应用：App Store提供
• Web客户端：直接访问ntfy.sh网页版
• 命令行工具：ntfy CLI客户端

🚀 最佳实践和技巧

1. 主题命名：使用有意义的主题名称，如server-backup-logs或home-security-alerts
2. 错误处理：在脚本中添加重试逻辑，确保重要通知不会丢失
3. 速率限制：注意免费服务的限制，重要系统建议自建实例
4. 消息格式：保持消息简洁，重要信息放在前面
5. 测试验证：发送测试消息确认所有订阅者都能收到

💡 实际应用场景

服务器监控

# CPU使用率报警
curl -H "Priority: high" -H "Tags: warning" -d "CPU使用率95%" ntfy.sh/server-monitor

# 磁盘空间不足
curl -H "Tags: cd" -d "/var磁盘剩余空间不足10%" ntfy.sh/disk-alerts

CI/CD通知

# 构建成功
curl -H "Tags: heavy_check_mark" -d "构建#123成功" ntfy.sh/ci-notifications

# 构建失败
curl -H "Priority: high" -H "Tags: warning" -d "构建#124失败" ntfy.sh/ci-notifications

家庭自动化

# 门铃通知
curl -H "Click: https://camera.example.com" -d "前门有人" ntfy.sh/home-doorbell

# 温度报警
curl -H "Tags: thermometer" -d "室内温度过高: 28°C" ntfy.sh/home-temp

ntfy的简单性和灵活性使其成为各种通知需求的理想解决方案。无论是个人使用还是企业集成，这个开源工具都能提供可靠的通知服务。