传感器与冷链:运作方式
「传感器与冷链」通过 API 接收您设备(冷藏柜、冷冻柜和房间记录仪、油箱液位计)的读数,每台设备一个密钥;当读数持续超出范围或设备静默时,通过应用、推送和电子邮件发出警报,并显示每台设备的曲线以及最小值、最大值、平均值和范围内时间。
第 5 课,共 12 课 · 运作方式
运作方式
打开「传感器与冷链」,添加设备及其序列号(设备发送的 ID)。冷藏柜会立即获得 2–8 °C 的范围,冷冻柜为最高 −18 °C;可在设备页面中修改范围。
在设备页面中选择«Create key»。密钥只显示一次:请将其写入设备或其网关。它只能上传此设备的读数。
设备向 /api/v1/sensors/readings 发送数据,每个请求最多 500 条读数(温度、湿度、油位或任意数值),并附带 Idempotency-Key 请求头,以确保重试绝不会被重复计数。帮助中心提供 curl 示例。
每个范围都有延迟时间:读数超出范围的时间超过延迟时间就会产生警报,拥有传感器权限的人员会通过应用、推送和电子邮件收到警报。读数回到范围内后,警报关闭,他们也会收到通知。设备静默时间超过设定的分钟数时,会触发«silent»警报。
确认警报时附上所采取措施的说明(已转移货物、已关门)。该说明会随警报保留,以备审核。
设备页面显示 24 小时、7 天或 30 天的曲线及允许区间、最小值、最大值、平均值、范围内时间占比以及超限情况。
原始读数按您设定的天数保留(默认 30 天),之后按小时汇总,因此长时间段也能快速显示。设备还可以自动填写 库存 → 冷链 中某个冷链单元的日志。
在哪里找到
- Sensors & cold chain
/admin/sensors
影响它的设置
- Sensors & cold chain → Retention
/admin/sensors
检查清单
继续之前,请确认您能够:
- 打开 Sensors & cold chain
- 打开「传感器与冷链」,添加设备及其序列号(设备发送的 ID)。冷藏柜会立即获得 2–8 °C 的范围,冷冻柜为最高 −18 °C;可在设备页面中修改范围。
- 在设备页面中选择Create key。密钥只显示一次:请将其写入设备或其网关。它只能上传此设备的读数。
- 设备向 /api/v1/sensors/readings 发送数据,每个请求最多 500 条读数(温度、湿度、油位或任意数值),并附带 Idempotency-Key 请求头,以确保重试绝不会被重复计数。帮助中心提供…
- 每个范围都有延迟时间:读数超出范围的时间超过延迟时间就会产生警报,拥有传感器权限的人员会通过应用、推送和电子邮件收到警报。读数回到范围内后,警报关闭,他们也会收到通知。设备静默时间超过设定的分钟数时,会触发silent…
提示和常见错误
- 为范围设置几分钟的延迟,这样装货时打开门不会触发警报。
- 停用不再使用的设备:其密钥会立即失效,读数会保留。
- 每台设备单独一个密钥最安全;具有 sensors:write 范围的通用密钥必须在每次上传时注明设备序列号。