# 当 读数越过界限 时，即刻知晓。

> 让 IoT 传感器的告警直达手机。ESP32、Raspberry Pi 或 Home Assistant 在读数超过阈值时，只需向 Pocket Alert 发送一次 HTTP POST 即可，无需 MQTT broker。

<!-- source: https://pocketalert.app/zh/use-cases/iot-sensor-alerts -->

最后更新：2026-08-11

温度、湿度、漏水、人体移动、门磁、电源或电量传感器越过阈值时，读数会直接发送到你的手机，支持 ESP32、树莓派、Home Assistant 或 Node-RED。无需消息代理，也无需 MQTT 桥接。

## 三步接入传感器告警

1. **获取令牌或 URL** — 创建一个 API 密钥，或为房间或设备复制应用的 Webhook URL。
2. **阈值触发时发送** — 把 POST 请求添加到你的 Arduino HTTPClient 草图、MicroPython 脚本、树莓派 cron 任务或 HA rest_command 中。
3. **在手机上查看** — 让传感器触发，你的手机会在一秒内震动提醒，通知出现在对应开发板的应用中。

## 任何传感器都能发出推送告警

传感器由你自己接线。只需一次 HTTP 调用，阈值告警就能送达你的手机，中间无需任何监控系统。

- **适配微控制器** — 一个普通的 HTTP POST 就能在 ESP32 或 ESP8266 上运行，资源依然充裕。无需消息代理，也无需桥接。
- **每个传感器一个通道** — 每块开发板一个应用，漏水告警醒目突出，电量提醒则保持平静。
- **按设备划分通道** — 每个房间或设备一个应用，车库、冰箱和温室的告警各自分开。
- **映射你自己的数据格式** — GJSON 字段映射可以从固件已发送的 JSON 中提取传感器名称和读数。
- **兼容你的现有方案** — Arduino、MicroPython、树莓派 curl、Home Assistant 自动化或 Node-RED 流程，都能访问同一个端点。
- **亚秒级送达** — 阈值触发后，推送在一秒内送达，赶在漏水扩散或冰箱解冻之前。

## 接入传感器

### 1. 创建 API 密钥

在 [API 密钥](https://pocketalert.app/zh/account/apikeys)页面创建一个密钥。你的设备在每次向消息 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 说明请阅读[文档](https://info.pocketalert.app/getting-started.html)。

## 常见问题

### 如何从传感器发送告警？

当读数越过阈值时，你的设备向消息 API 发送一次 HTTP POST。在 ESP32 或 ESP8266 上，这只需要几行 Arduino 代码，使用 HTTPClient 或 MicroPython 即可；在树莓派上则是一条 curl 命令。请求负载包含标题和消息内容，API 密钥放在 Token 请求头中。

### 我需要 MQTT 或消息代理吗？

一个普通的 HTTPS 请求就能轻松放进 ESP32，还绰绰有余。无需 MQTT 代理，也不用维护额外的桥接容器。如果你已经在用 Home Assistant 的 rest_command 或 Node-RED，它们同样可以直接使用。

### 紧急读数能与日常读数区分开吗？

为每块开发板创建独立的应用，让冰箱、温室和漏水传感器各自拥有独立的通道。标题写得醒目一些，漏水时一眼就能看出；电量低的提醒则可以放在自己的应用里，保持平静。

### 如何把不同房间和设备分开？

为每个房间或设备创建一个应用。车库、冰箱和温室各自拥有独立的通道，你不用眯着眼睛分辨是哪块板子发出的告警。

### 能读取我现有的传感器数据吗？

将 GJSON 字段映射指向固件已经发送的键名，传感器名称和读数就能直接填入标题和消息，无需在开发板上重新组织 JSON。

### 夜间漏水告警能突破勿扰模式吗？

可以。在 POST 中加入 "level":"critical"，Android 会通过专用通知通道发送，并绕过勿扰模式，你只需授予一次勿扰权限。在 iPhone 上，high 和 critical 会作为时效性通知送达，可以突破专注模式。电量低的提醒可以改用 level silent：没有声音和震动，只会留在通知历史中。在免费套餐中，critical 会按 high 发送，依然是即时送达，但不会绕过勿扰模式。
