任何传感器都能发出推送告警
传感器由你自己接线。只需一次 HTTP 调用,阈值告警就能送达你的手机,中间无需任何监控系统。
适配微控制器
一个普通的 HTTP POST 就能在 ESP32 或 ESP8266 上运行,资源依然充裕。无需消息代理,也无需桥接。
每个传感器一个通道
每块开发板一个应用,漏水告警醒目突出,电量提醒则保持平静。
按设备划分通道
每个房间或设备一个应用,车库、冰箱和温室的告警各自分开。
映射你自己的数据格式
GJSON 字段映射可以从固件已发送的 JSON 中提取传感器名称和读数。
兼容你的现有方案
Arduino、MicroPython、树莓派 curl、Home Assistant 自动化或 Node-RED 流程,都能访问同一个端点。
亚秒级送达
阈值触发后,推送在一秒内送达,赶在漏水扩散或冰箱解冻之前。
三步接入传感器告警
获取令牌或 URL
创建一个 API 密钥,或为房间或设备复制应用的 Webhook URL。
阈值触发时发送
把 POST 请求添加到你的 Arduino HTTPClient 草图、MicroPython 脚本、树莓派 cron 任务或 HA rest_command 中。
在手机上查看
让传感器触发,你的手机会在一秒内震动提醒,通知出现在对应开发板的应用中。
接入传感器
1. 创建 API 密钥
在 API 密钥页面创建一个密钥。你的设备在每次向消息 API 发送 POST 时,都需要在 Token 请求头中携带它。
2. 阈值触发时发送 POST
curl -X POST "https://api.pocketalert.app/v1/messages" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Freezer warm","message":"garage freezer at 4.2C","application_id":"qm47b9pzxzxg"}'
3. 在 ESP32 或 ESP8266 上(Arduino)
#include <WiFiClientSecure.h>
#include <HTTPClient.h>
WiFiClientSecure client;
client.setInsecure(); // or client.setCACert(rootCA);
HTTPClient http;
http.begin(client, "https://api.pocketalert.app/v1/messages");
http.addHeader("Token", "YOUR_API_KEY");
http.addHeader("Content-Type", "application/json");
http.POST("{\"title\":\"Water leak\",\"level\":\"critical\",\"message\":\"basement sensor wet\"}");
http.end();
4. 或通过 Home Assistant
rest_command:
pocketalert:
url: "https://api.pocketalert.app/v1/messages"
method: POST
headers:
Token: "YOUR_API_KEY"
content_type: "application/json"
payload: '{"title":"{{ title }}","message":"{{ message }}"}'
在自动化中调用 rest_command.pocketalert,或在 Node-RED 中配置 MQTT 转 REST 的流程。完整的消息 API 说明请阅读文档。
常见问题解答
当读数越过阈值时,你的设备向消息 API 发送一次 HTTP POST。在 ESP32 或 ESP8266 上,这只需要几行 Arduino 代码,使用 HTTPClient 或 MicroPython 即可;在树莓派上则是一条 curl 命令。请求负载包含标题和消息内容,API 密钥放在 Token 请求头中。
一个普通的 HTTPS 请求就能轻松放进 ESP32,还绰绰有余。无需 MQTT 代理,也不用维护额外的桥接容器。如果你已经在用 Home Assistant 的 rest_command 或 Node-RED,它们同样可以直接使用。
为每块开发板创建独立的应用,让冰箱、温室和漏水传感器各自拥有独立的通道。标题写得醒目一些,漏水时一眼就能看出;电量低的提醒则可以放在自己的应用里,保持平静。
为每个房间或设备创建一个应用。车库、冰箱和温室各自拥有独立的通道,你不用眯着眼睛分辨是哪块板子发出的告警。
将 GJSON 字段映射指向固件已经发送的键名,传感器名称和读数就能直接填入标题和消息,无需在开发板上重新组织 JSON。
可以。在 POST 中加入 "level":"critical",Android 会通过专用通知通道发送,并绕过勿扰模式,你只需授予一次勿扰权限。在 iPhone 上,high 和 critical 会作为时效性通知送达,可以突破专注模式。电量低的提醒可以改用 level silent:没有声音和震动,只会留在通知历史中。在免费套餐中,critical 会按 high 发送,依然是即时送达,但不会绕过勿扰模式。