# 监控告警别再只盯手机用 HTTP API 把 Zabbix/Prometheus 告警打到博灵语音通知终端声光TTS 实战 日期2026-08-28 适用运维、DevOps、机房值班、数据中心监控对接 产品关键词覆盖博灵、博灵 Q 系列、博灵智能监控终端、博灵语音通知终端、网络报警灯、智能报警灯、语音报警灯、声光告警、声光播报、可编程报警灯、TTS 语音播报、HTTP API、API 签名、WebHook、通知组、播报队列---## 一、先说痛点告警链路“到人了”机房现场却“没声没光”做机房运维、数据中心监控、动力环境监测的人都遇到过这类场景- Zabbix / Prometheus / 云监控阿里云、腾讯云告警已经推到钉钉、企业微信、邮件、短信- 值班同学在工位或远程手机震了但**机房现场、监控室、值班台**没有即时声光提醒- 视频监控异常、服务器宕机、PLC/组态阈值超限时现场人员仍靠“刷大屏”或“等人喊”。本质问题不是“监控系统不够强”而是**告警出口少了一层“现场可感知”的执行器**。这时很适合引入一类专用设备**网络报警灯 / 智能报警灯 / 语音报警灯 / 可编程报警灯**——也就是 **博灵 Q 系列博灵智能监控终端 / 博灵语音通知终端** 这类支持 **HTTP API 声光告警 TTS 语音播报** 的终端。本文将以技术对接视角完整演示1. 如何开启博灵语音通知终端的声光播报 API2. 如何实现 API 签名token time MD53. 如何调用单次告警接口 send_msg 触发自定义声光 TTS4. 如何用 WebHook / 自定义 API 对接现有监控平台5. 如何管理播报队列跳过、清空、周期播报。官方产品介绍可参考[博灵 Q 系列产品介绍](https://eyegroup.cc/model-q/pro-desc/)---## 二、博灵 Q 系列是什么可被 HTTP 调用的“声光语音执行器”**博灵智能监控终端博灵语音通知终端** 是新一代智能语音声光告警设备。设备通过 **RJ45** 或 **Wi-Fi** 接入网络经以太网远程控制实现自定义声光与语音播报。一句话理解 监控平台负责“发现故障”**博灵网络报警灯**负责“现场说出来、亮起来”。### 2.1 为什么适合做技术对接- **HTTP API 优先**form-data / JSON 都支持运维脚本、Python、Postman、各语言 SDK 都能打- **自定义 API / WebHook**对方回调字段不标准时可在设备侧做字段映射与拼接- **TTS 语音播报**告警详情可直接读出来主机、指标、级别、时间- **全彩 LED 声光告警**转亮 / 闪亮 / 常亮 / 脉动通知组可配多层颜色- **工业扩展**Modbus TCP 可对接 PLC、组态主机监控支持 Ping、TCP 端口、SNMP、网页监控- **兼容旧链路**可兼容“黑猫侦探智能网络报警灯”旧接口映射场景。### 2.2 典型落地场景关键词场景化| 场景 | 怎么用博灵语音通知终端 ||---|---|| 数据中心 | 与监控平台联动服务器故障时声光告警 TTS 播报告警详情 || 监控室 | 与监控大屏联动视频异常时语音提醒值班人员 || 小规模机房 | 设备自带主机监控SNMP / Ping / TCP 端口本地声光语音播报 || 工业现场 | PLC / 组态经 Modbus TCP 推送点位告警 || 业务系统 | MIS / ERP / BPM / OA / 工单 / 合规平台 WebHook 推送关键事项 |---## 三、对接架构监控系统 → HTTP → 博灵声光语音终端推荐把博灵 Q 系列当成“告警执行层”不要替代现有监控中枢。text[监控平台]Zabbix / Prometheus Alertmanager / 云监控 / 工单系统|| WebHook / HTTP POST (form-data 或 JSON)v[可选中间件/脚本]签名计算、字段规范化、重试、限流|| POST /api/api/send_msg 或 /api/api/user_msg/{path}v[博灵智能监控终端 / 网络报警灯]通知组样式 全彩LED TTS语音播报 播报队列**配图说明提纲 ①架构图**标题监控告警到博灵语音通知终端的数据流画面建议左侧画“Zabbix/Prometheus/云监控”三个盒子中间箭头标注 HTTP POST API签名右侧画“博灵Q系列报警灯”旁注 声光告警 / TTS / 播报队列底部小字写 也可走自定义API/WebHook映射。---## 四、上线前准备开机、配网、打开声光播报 API### 4.1 快速配网传统方式1. 设备初始有线 IP192.168.0.662. 电脑临时设为192.168.0.10 / 255.255.255.03. Chrome 内核浏览器访问 http://192.168.0.664. 默认账号务必首登修改admin / 1234565. 在「系统设置 → 网络设置」改成正式网段后接入业务网络另支持**组播配网**适合批量部署脚本可按 Windows / Linux / Python 运行。**配图说明提纲 ②配网界面**截图登录后的网络设置页红框标出静态 IP、网关、DNS角标文字博灵语音通知终端首次配网。### 4.2 打开 API 能力关键对接 HTTP API 前必须1. 进入 Api → Api启停打开 **声光播报**2. 配置 **API Key**文档演示默认 key 常见为 1qaz2wsx生产环境务必更换3. 在安全设置中确认是否开启 API 签名生产建议开启。**配图说明提纲 ③API启停**截图Api 启停页勾选“声光播报”旁边注明 未开启则 send_msg 不会真正播报。---## 五、核心能力 1API 签名算法全平台可复用博灵语音通知终端的签名逻辑清晰适合写进运维工具库。### 5.1 算法步骤1. 在请求参数中加入 token API Key和 time当前秒级时间戳2. 按 key **字典升序**排列3. 按 key value 直接拼接得到 sign_str无分隔符4. 对 sign_str 做 **MD5**得到 sign5. 最终请求携带业务参数 time sign一般不再传 token。注意请求时间戳与设备时间误差需在 **120 秒**内否则签名易失败。请先在设备「时间设置」打开 NTP。### 5.2 Python 签名示例pythonimport hashlibimport jsonimport timefrom typing import Any, DictAPI_KEY REPLACE_WITH_YOUR_API_KEY # 切勿使用默认演示密钥上生产def build_sign(params: Dict[str, Any], token: str) - str:博灵 Q 系列 HTTP API 签名token time 字典序拼接 MD5payload dict(params)payload[token] token# 非字符串统一转成签名侧可复现的文本normalized {}for k, v in payload.items():if isinstance(v, (dict, list)):normalized[k] json.dumps(v, ensure_asciiFalse, separators(,, :))else:normalized[k] str(v)sign_str .join(f{k}{normalized[k]} for k in sorted(normalized.keys()))return hashlib.md5(sign_str.encode(utf-8)).hexdigest()def with_sign(biz_params: Dict[str, Any], token: str API_KEY) - Dict[str, Any]:data dict(biz_params)data[time] str(int(time.time()))data[sign] build_sign(data, token)return data### 5.3 文档同款验算便于自测假设业务参数- led_style15- color[#123456]- led_flag[0.1,1]- text好用的声光播报终端- time1668843530- token1qaz2wsx拼接串textcolor[#123456]led_flag[0.1,1]led_style15text好用的声光播报终端time1668843530token1qaz2wsxMD5 结果textdc76013f54527b7074e4076e86fba803**配图说明提纲 ④签名流程图**竖向 4 步加 token/time → 字典排序 → keyvalue 拼接 → MD5右侧放一段 sign_str 样例截断显示。---## 六、核心能力 2单次告警 send_msg声光 TTS单次告警是博灵智能监控终端最核心的 HTTP API触发一次自定义声光语音播报。- URLhttp://设备IP/api/api/send_msg- MethodPOST- 数据类型form-data设备 API 也普遍支持 JSON### 6.1 常用参数写文章/对接时重点记| 参数 | 说明 ||---|---|| led_style | LED 样式15转亮 / 20闪亮 / 25常亮 / 30脉动 || color | 颜色 JSON如 {1:[#00ffff]} 或 {1:[blue]} || led_flag | 样式参数如转亮推荐 [0.03,1]闪亮推荐 [1,1] || text | TTS 文本最长约 150 字超长可能截断 || tts_speed | 语速 1~10 || play_time | 播报时长上限超时截断 || repeat_count | 重复次数默认 1 || tone | 提示音编号通知组里可查 || sound | 0女声 / 1男声 || time / sign | 签名相关必填开启鉴权时 |### 6.2 Python 完整调用示例pythonimport requestsDEVICE_IP 192.168.0.66def send_once_alarm(text: str,led_style: str 15,colorNone,led_flagNone,tts_speed: int 5,tone: str 0,sound: str 0,):if color is None:color {1: [#FF3300]} # 告警红if led_flag is None:led_flag [0.03, 1] # 转亮biz {led_style: led_style,color: color,led_flag: led_flag,text: text,tts_speed: tts_speed,tone: tone,sound: sound,repeat_count: 1,}payload with_sign(biz)url fhttp://{DEVICE_IP}/api/api/send_msg# 也可用 jsonpayload此处按文档常用 form-dataform {k: (json.dumps(v, ensure_asciiFalse) if isinstance(v, (dict, list)) else str(v))for k, v in payload.items()}resp requests.post(url, timeout5, dataform)resp.raise_for_status()return resp.json()if __name__ __main__:result send_once_alarm(text数据中心告警主机 web-01 CPU 持续超过 90%请值班人员立即检查)print(result)# 典型成功# {code:200,msg:OK,data:{method:50,id:...,data:1,res_code:0}}# data.data 当前播报队列剩余待播数量### 6.3 curl 快速验证bash# 先用脚本算出 time/sign再替换下列占位符curl -X POST http://192.168.0.66/api/api/send_msg \-F led_style15 \-F color{1:[#FF3300]} \-F led_flag[0.03,1] \-F text博灵语音通知终端联调成功声光告警与TTS语音播报正常 \-F tts_speed5 \-F tone0 \-F sound0 \-F timeREPLACE_TS \-F signREPLACE_SIGN**配图说明提纲 ⑤Postman 调试**截图Postman POST send_msgBody 选 form-data高亮 text/led_style/sign/time右上角返回 code200设备实物旁可放一张“红光转亮扬声器”示意。---## 七、把现网监控接到博灵三条落地路径### 路径 A监控平台直接调 send_msg最干净适合你能控制 WebHook 报文结构或中间有一层告警网关。做法1. Alertmanager / Zabbix 媒体类型指向你的小网关2. 网关负责拼 text、选 led_style、算签名3. 转发到博灵网络报警灯。伪代码Alertmanager Webhook 接收端pythonfrom flask import Flask, requestapp Flask(__name__)app.post(/hook/alertmanager)def hook_alertmanager():body request.get_json(forceTrue)alerts body.get(alerts, [])for a in alerts:status a.get(status, firing)labels a.get(labels, {})annotations a.get(annotations, {})host labels.get(instance, unknown)alertname labels.get(alertname, alert)summary annotations.get(summary, )text f{恢复 if statusresolved else 告警}{alertname}主机{host}{summary}style 25 if status resolved else 15 # 恢复常亮/告警转亮color {1: [#00AA00]} if status resolved else {1: [#FF3300]}send_once_alarm(texttext[:150], led_stylestyle, colorcolor)return {ok: True}### 路径 B用博灵「自定义 API」吃异构 WebHook最省改动很多平台含部分云监控、工单、合规系统支持 HTTP 回调但字段是对方定的例如- host 告警主机- serv 告警服务- level 1严重 / 2警告 / 3恢复- time 发生时间此时不必强行改对方直接在 **博灵 Q 系列** 管理界面配置1. Api → 自定义Api接口 新建路径例如 alarm2. 最终接收地址http://设备IP/api/api/user_msg/alarm3. 用“固定文本 普通字段 映射字段”拼接 TTS 文本4. 用 level 映射不同通知组红转亮 / 黄转亮 / 绿常亮拼接效果示例text主机web-01 服务CPU使用率 级别严重**配图说明提纲 ⑥自定义 API 映射**三栏对照左侧“对方 WebHook JSON”中间“字段映射规则”右侧“博灵 TTS 播报句子 LED 通知组”。### 路径 CNAT/跨公网场景走云服务中继当设备在内网、告警源无法直连 IP 时可启用博灵云服务把原http://设备IP/api/api/send_msg替换为云端路径形态示例https://api.eyegroup.cc/alerter/设备通道ID/api/send_msg业务参数基本不变适合分支机房、家庭实验室、临时远程联调。注意关注平台队列深度与同步延迟字段如 last_pull。---## 八、别忽略“播报队列”值班现场最怕告警风暴博灵语音通知终端不是“来一条打一条喇叭到底不管”而是有明确的队列语义| 能力 | 接口意图 ||---|---|| 获取待播数量 | GET /api/api/get_play_queue_size || 跳过当前播报 | POST /api/api/play_next可选择是否删除周期任务 || 清空待播队列 | GET /api/api/clear_queue || 周期性播报 | POST /api/api/set_api_repeat_alarm返回 cid || 无限循环播报 | POST /api/api/not_stop_repeat_alarm || 删除重复播报 | POST /api/home/del_repeat_alarm按 cid/id |实践建议1. **告警风暴**先聚合同一 hostalertname 1 分钟合并再推博灵2. **致命故障**用无限循环/高重复通知组直到人工确认后删 cid3. **恢复事件**用绿色常亮短播报并清理对应循环任务4. **物理按键**可在系统设置把短按/长按映射为“跳过当前 / 清空指定告警”方便值班员现场消音。pythondef get_queue_size(ip: str) - int:r requests.get(fhttp://{ip}/api/api/get_play_queue_size, timeout3)return int(r.json()[data][data])def clear_queue(ip: str) - None:requests.get(fhttp://{ip}/api/api/clear_queue, timeout3).raise_for_status()**配图说明提纲 ⑦首页告警列表**截图设备 Web 首页告警列表标注“周期播报 / 循环播报 / 删除按钮 / 队列长度”。---## 九、通知组与灯效让“颜色级别”成为值班共识建议在博灵智能监控终端里预先建好通知组而不是每次 API 都裸传样式| 通知组 | LED | 语音 | 用途 ||---|---|---|---|| critical | 红转亮 | 开重复更高 | 宕机、断电、核心链路中断 || warning | 黄闪亮 | 开 | 阈值越界、磁盘将满 || info | 蓝脉动 | 可选 | 变更提醒、工单到达 || recovered | 绿常亮短时 | 开 | 故障恢复 |系统设置里还可配置- 全局 TTS 语速1~10- 在线/仅离线语音合成- 自定义提示音wav≤2MB最多 10 个- 声光免打扰按周- 待机样式呼吸、贪吃蛇、灯塔、火焰等**配图说明提纲 ⑧通知组编辑页**截图通知组编辑红框“重复播报次数 / 播报间隔 / 多层颜色 / 语音开关 / 提示音 / 免打扰”。---## 十、联调清单可直接当验收用例1. **网络**浏览器能打开设备管理页设备能 NTP 同步。2. **权限**API Key 已轮换签名开关与脚本一致。3. **启停**声光播报 API 已启用。4. **单次告警**send_msg 返回 200现场听到 TTS、看到转亮。5. **签名失败用例**故意改 time 超 120s确认被拒绝。6. **队列**连续推 5 条get_play_queue_size 递增clear_queue 后归零。7. **WebHook**从真实监控打一条 firing 一条 resolved。8. **日志**在「系统日志 → Api调用日志 / 播报日志」核对请求与播报记录。9. **备份**配置稳定后做一次备份还原演练。**配图说明提纲 ⑨日志页**左右分栏左 Api 调用日志含路径、状态码右播报日志文本、时间、通知组。---## 十一、常见坑省你半天1. **只配了 IP没开声光播报开关** → 接口可能通灯不响。2. **设备时间不准** → 签名 120 秒窗口直接失败。3. **JSON 序列化不一致** → 签名时 color/led_flag 的空格、引号要与实际提交一致。4. **TTS 文本过长** → 超长截断关键主机名放句子前部。5. **告警风暴无聚合** → 队列堆积现场噪音疲劳先做抑制再推终端。6. **生产仍用默认密码/默认 API Key** → 局域网内可被误触发务必修改。7. **跨网段无路由/无云服务** → 告警源根本打不到设备先做连通性。---## 十二、小结把“可见的监控”升级成“可感知的现场告警”如果你已经有一套 IT 信息化 / 运维监控系统缺的往往不是再多一个图表而是把告警变成**机房可感知的声光语音事件**。**博灵 Q 系列博灵智能监控终端 / 博灵语音通知终端** 的价值在于- 用标准 **HTTP API** 接入几乎所有告警源- 用 **API 签名** 保证调用可校验- 用 **自定义 API / WebHook** 兼容异构字段- 用 **全彩 LED TTS 语音播报 通知组 播报队列** 完成现场闭环- 需要时还能扩展到 **Modbus TCP、SNMP、Ping、邮件监控、云服务中继、阿里云短信**。建议落地顺序1. 单机 send_msg 跑通2. 通知组按级别固化3. 接一条真实 WebHook4. 再加队列治理与恢复告警5. 最后视情况上云服务或工业 Modbus。官方文档入口- 产品介绍https://eyegroup.cc/model-q/pro-desc/- 快速入门签名https://eyegroup.cc/model-q/quick-door/- 单次告警 APIhttps://eyegroup.cc/model-q/once-api/---## 附配图总提纲建议 9 张全平台通用| 序号 | 文件建议名 | 画面内容 | 图注文案 ||---|---|---|---|| 1 | 01-architecture.png | 监控→HTTP签名→博灵终端 | 监控告警到博灵语音通知终端的数据流 || 2 | 02-network-setup.png | 网络设置页 | 博灵Q系列首次配网与静态IP || 3 | 03-api-switch.png | API启停 | 启用声光播报后才能HTTP触发 || 4 | 04-sign-flow.png | 签名四步示意 | tokentime字典序MD5签名 || 5 | 05-postman-send-msg.png | Postman调send_msg | 单次声光告警与TTS联调 || 6 | 06-custom-api-map.png | WebHook字段映射 | 自定义API兼容异构监控回调 || 7 | 07-alarm-queue.png | 首页告警/队列 | 周期播报、循环播报与队列治理 || 8 | 08-notify-group.png | 通知组编辑 | 用颜色和语音表达告警级别 || 9 | 09-logs.png | API/播报日志 | 联调验收看系统日志 |---### 发布提示CSDN / 知乎等- 标题可直接用本文标题或改成更检索向HTTP API对接博灵语音通知终端签名算法send_msg声光TTS实战- 正文已按技术笔记结构写关键词密度高若平台提示广告属性在文首加一句“基于官方文档的对接实践/设备体验笔记”即可- 代码块保留便于过“技术文”审阅外链用官网文档避免站外引流过度 小机房没监控平台怎么办？博灵 Q 系列自带主机监控：Ping / SNMP / 网页监控声光语音告警实战
# 监控告警别再只盯手机用 HTTP API 把 Zabbix/Prometheus 告警打到博灵语音通知终端声光TTS 实战 日期2026-08-28 适用运维、DevOps、机房值班、数据中心监控对接 产品关键词覆盖博灵、博灵 Q 系列、博灵智能监控终端、博灵语音通知终端、网络报警灯、智能报警灯、语音报警灯、声光告警、声光播报、可编程报警灯、TTS 语音播报、HTTP API、API 签名、WebHook、通知组、播报队列---## 一、先说痛点告警链路“到人了”机房现场却“没声没光”做机房运维、数据中心监控、动力环境监测的人都遇到过这类场景- Zabbix / Prometheus / 云监控阿里云、腾讯云告警已经推到钉钉、企业微信、邮件、短信- 值班同学在工位或远程手机震了但**机房现场、监控室、值班台**没有即时声光提醒- 视频监控异常、服务器宕机、PLC/组态阈值超限时现场人员仍靠“刷大屏”或“等人喊”。本质问题不是“监控系统不够强”而是**告警出口少了一层“现场可感知”的执行器**。这时很适合引入一类专用设备**网络报警灯 / 智能报警灯 / 语音报警灯 / 可编程报警灯**——也就是 **博灵 Q 系列博灵智能监控终端 / 博灵语音通知终端** 这类支持 **HTTP API 声光告警 TTS 语音播报** 的终端。本文将以技术对接视角完整演示1. 如何开启博灵语音通知终端的声光播报 API2. 如何实现 API 签名token time MD53. 如何调用单次告警接口 send_msg 触发自定义声光 TTS4. 如何用 WebHook / 自定义 API 对接现有监控平台5. 如何管理播报队列跳过、清空、周期播报。官方产品介绍可参考[博灵 Q 系列产品介绍](https://eyegroup.cc/model-q/pro-desc/)---## 二、博灵 Q 系列是什么可被 HTTP 调用的“声光语音执行器”**博灵智能监控终端博灵语音通知终端** 是新一代智能语音声光告警设备。设备通过 **RJ45** 或 **Wi-Fi** 接入网络经以太网远程控制实现自定义声光与语音播报。一句话理解 监控平台负责“发现故障”**博灵网络报警灯**负责“现场说出来、亮起来”。### 2.1 为什么适合做技术对接- **HTTP API 优先**form-data / JSON 都支持运维脚本、Python、Postman、各语言 SDK 都能打- **自定义 API / WebHook**对方回调字段不标准时可在设备侧做字段映射与拼接- **TTS 语音播报**告警详情可直接读出来主机、指标、级别、时间- **全彩 LED 声光告警**转亮 / 闪亮 / 常亮 / 脉动通知组可配多层颜色- **工业扩展**Modbus TCP 可对接 PLC、组态主机监控支持 Ping、TCP 端口、SNMP、网页监控- **兼容旧链路**可兼容“黑猫侦探智能网络报警灯”旧接口映射场景。### 2.2 典型落地场景关键词场景化| 场景 | 怎么用博灵语音通知终端 ||---|---|| 数据中心 | 与监控平台联动服务器故障时声光告警 TTS 播报告警详情 || 监控室 | 与监控大屏联动视频异常时语音提醒值班人员 || 小规模机房 | 设备自带主机监控SNMP / Ping / TCP 端口本地声光语音播报 || 工业现场 | PLC / 组态经 Modbus TCP 推送点位告警 || 业务系统 | MIS / ERP / BPM / OA / 工单 / 合规平台 WebHook 推送关键事项 |---## 三、对接架构监控系统 → HTTP → 博灵声光语音终端推荐把博灵 Q 系列当成“告警执行层”不要替代现有监控中枢。text[监控平台]Zabbix / Prometheus Alertmanager / 云监控 / 工单系统|| WebHook / HTTP POST (form-data 或 JSON)v[可选中间件/脚本]签名计算、字段规范化、重试、限流|| POST /api/api/send_msg 或 /api/api/user_msg/{path}v[博灵智能监控终端 / 网络报警灯]通知组样式 全彩LED TTS语音播报 播报队列**配图说明提纲 ①架构图**标题监控告警到博灵语音通知终端的数据流画面建议左侧画“Zabbix/Prometheus/云监控”三个盒子中间箭头标注 HTTP POST API签名右侧画“博灵Q系列报警灯”旁注 声光告警 / TTS / 播报队列底部小字写 也可走自定义API/WebHook映射。---## 四、上线前准备开机、配网、打开声光播报 API### 4.1 快速配网传统方式1. 设备初始有线 IP192.168.0.662. 电脑临时设为192.168.0.10 / 255.255.255.03. Chrome 内核浏览器访问 http://192.168.0.664. 默认账号务必首登修改admin / 1234565. 在「系统设置 → 网络设置」改成正式网段后接入业务网络另支持**组播配网**适合批量部署脚本可按 Windows / Linux / Python 运行。**配图说明提纲 ②配网界面**截图登录后的网络设置页红框标出静态 IP、网关、DNS角标文字博灵语音通知终端首次配网。### 4.2 打开 API 能力关键对接 HTTP API 前必须1. 进入 Api → Api启停打开 **声光播报**2. 配置 **API Key**文档演示默认 key 常见为 1qaz2wsx生产环境务必更换3. 在安全设置中确认是否开启 API 签名生产建议开启。**配图说明提纲 ③API启停**截图Api 启停页勾选“声光播报”旁边注明 未开启则 send_msg 不会真正播报。---## 五、核心能力 1API 签名算法全平台可复用博灵语音通知终端的签名逻辑清晰适合写进运维工具库。### 5.1 算法步骤1. 在请求参数中加入 token API Key和 time当前秒级时间戳2. 按 key **字典升序**排列3. 按 key value 直接拼接得到 sign_str无分隔符4. 对 sign_str 做 **MD5**得到 sign5. 最终请求携带业务参数 time sign一般不再传 token。注意请求时间戳与设备时间误差需在 **120 秒**内否则签名易失败。请先在设备「时间设置」打开 NTP。### 5.2 Python 签名示例pythonimport hashlibimport jsonimport timefrom typing import Any, DictAPI_KEY REPLACE_WITH_YOUR_API_KEY # 切勿使用默认演示密钥上生产def build_sign(params: Dict[str, Any], token: str) - str:博灵 Q 系列 HTTP API 签名token time 字典序拼接 MD5payload dict(params)payload[token] token# 非字符串统一转成签名侧可复现的文本normalized {}for k, v in payload.items():if isinstance(v, (dict, list)):normalized[k] json.dumps(v, ensure_asciiFalse, separators(,, :))else:normalized[k] str(v)sign_str .join(f{k}{normalized[k]} for k in sorted(normalized.keys()))return hashlib.md5(sign_str.encode(utf-8)).hexdigest()def with_sign(biz_params: Dict[str, Any], token: str API_KEY) - Dict[str, Any]:data dict(biz_params)data[time] str(int(time.time()))data[sign] build_sign(data, token)return data### 5.3 文档同款验算便于自测假设业务参数- led_style15- color[#123456]- led_flag[0.1,1]- text好用的声光播报终端- time1668843530- token1qaz2wsx拼接串textcolor[#123456]led_flag[0.1,1]led_style15text好用的声光播报终端time1668843530token1qaz2wsxMD5 结果textdc76013f54527b7074e4076e86fba803**配图说明提纲 ④签名流程图**竖向 4 步加 token/time → 字典排序 → keyvalue 拼接 → MD5右侧放一段 sign_str 样例截断显示。---## 六、核心能力 2单次告警 send_msg声光 TTS单次告警是博灵智能监控终端最核心的 HTTP API触发一次自定义声光语音播报。- URLhttp://设备IP/api/api/send_msg- MethodPOST- 数据类型form-data设备 API 也普遍支持 JSON### 6.1 常用参数写文章/对接时重点记| 参数 | 说明 ||---|---|| led_style | LED 样式15转亮 / 20闪亮 / 25常亮 / 30脉动 || color | 颜色 JSON如 {1:[#00ffff]} 或 {1:[blue]} || led_flag | 样式参数如转亮推荐 [0.03,1]闪亮推荐 [1,1] || text | TTS 文本最长约 150 字超长可能截断 || tts_speed | 语速 1~10 || play_time | 播报时长上限超时截断 || repeat_count | 重复次数默认 1 || tone | 提示音编号通知组里可查 || sound | 0女声 / 1男声 || time / sign | 签名相关必填开启鉴权时 |### 6.2 Python 完整调用示例pythonimport requestsDEVICE_IP 192.168.0.66def send_once_alarm(text: str,led_style: str 15,colorNone,led_flagNone,tts_speed: int 5,tone: str 0,sound: str 0,):if color is None:color {1: [#FF3300]} # 告警红if led_flag is None:led_flag [0.03, 1] # 转亮biz {led_style: led_style,color: color,led_flag: led_flag,text: text,tts_speed: tts_speed,tone: tone,sound: sound,repeat_count: 1,}payload with_sign(biz)url fhttp://{DEVICE_IP}/api/api/send_msg# 也可用 jsonpayload此处按文档常用 form-dataform {k: (json.dumps(v, ensure_asciiFalse) if isinstance(v, (dict, list)) else str(v))for k, v in payload.items()}resp requests.post(url, timeout5, dataform)resp.raise_for_status()return resp.json()if __name__ __main__:result send_once_alarm(text数据中心告警主机 web-01 CPU 持续超过 90%请值班人员立即检查)print(result)# 典型成功# {code:200,msg:OK,data:{method:50,id:...,data:1,res_code:0}}# data.data 当前播报队列剩余待播数量### 6.3 curl 快速验证bash# 先用脚本算出 time/sign再替换下列占位符curl -X POST http://192.168.0.66/api/api/send_msg \-F led_style15 \-F color{1:[#FF3300]} \-F led_flag[0.03,1] \-F text博灵语音通知终端联调成功声光告警与TTS语音播报正常 \-F tts_speed5 \-F tone0 \-F sound0 \-F timeREPLACE_TS \-F signREPLACE_SIGN**配图说明提纲 ⑤Postman 调试**截图Postman POST send_msgBody 选 form-data高亮 text/led_style/sign/time右上角返回 code200设备实物旁可放一张“红光转亮扬声器”示意。---## 七、把现网监控接到博灵三条落地路径### 路径 A监控平台直接调 send_msg最干净适合你能控制 WebHook 报文结构或中间有一层告警网关。做法1. Alertmanager / Zabbix 媒体类型指向你的小网关2. 网关负责拼 text、选 led_style、算签名3. 转发到博灵网络报警灯。伪代码Alertmanager Webhook 接收端pythonfrom flask import Flask, requestapp Flask(__name__)app.post(/hook/alertmanager)def hook_alertmanager():body request.get_json(forceTrue)alerts body.get(alerts, [])for a in alerts:status a.get(status, firing)labels a.get(labels, {})annotations a.get(annotations, {})host labels.get(instance, unknown)alertname labels.get(alertname, alert)summary annotations.get(summary, )text f{恢复 if statusresolved else 告警}{alertname}主机{host}{summary}style 25 if status resolved else 15 # 恢复常亮/告警转亮color {1: [#00AA00]} if status resolved else {1: [#FF3300]}send_once_alarm(texttext[:150], led_stylestyle, colorcolor)return {ok: True}### 路径 B用博灵「自定义 API」吃异构 WebHook最省改动很多平台含部分云监控、工单、合规系统支持 HTTP 回调但字段是对方定的例如- host 告警主机- serv 告警服务- level 1严重 / 2警告 / 3恢复- time 发生时间此时不必强行改对方直接在 **博灵 Q 系列** 管理界面配置1. Api → 自定义Api接口 新建路径例如 alarm2. 最终接收地址http://设备IP/api/api/user_msg/alarm3. 用“固定文本 普通字段 映射字段”拼接 TTS 文本4. 用 level 映射不同通知组红转亮 / 黄转亮 / 绿常亮拼接效果示例text主机web-01 服务CPU使用率 级别严重**配图说明提纲 ⑥自定义 API 映射**三栏对照左侧“对方 WebHook JSON”中间“字段映射规则”右侧“博灵 TTS 播报句子 LED 通知组”。### 路径 CNAT/跨公网场景走云服务中继当设备在内网、告警源无法直连 IP 时可启用博灵云服务把原http://设备IP/api/api/send_msg替换为云端路径形态示例https://api.eyegroup.cc/alerter/设备通道ID/api/send_msg业务参数基本不变适合分支机房、家庭实验室、临时远程联调。注意关注平台队列深度与同步延迟字段如 last_pull。---## 八、别忽略“播报队列”值班现场最怕告警风暴博灵语音通知终端不是“来一条打一条喇叭到底不管”而是有明确的队列语义| 能力 | 接口意图 ||---|---|| 获取待播数量 | GET /api/api/get_play_queue_size || 跳过当前播报 | POST /api/api/play_next可选择是否删除周期任务 || 清空待播队列 | GET /api/api/clear_queue || 周期性播报 | POST /api/api/set_api_repeat_alarm返回 cid || 无限循环播报 | POST /api/api/not_stop_repeat_alarm || 删除重复播报 | POST /api/home/del_repeat_alarm按 cid/id |实践建议1. **告警风暴**先聚合同一 hostalertname 1 分钟合并再推博灵2. **致命故障**用无限循环/高重复通知组直到人工确认后删 cid3. **恢复事件**用绿色常亮短播报并清理对应循环任务4. **物理按键**可在系统设置把短按/长按映射为“跳过当前 / 清空指定告警”方便值班员现场消音。pythondef get_queue_size(ip: str) - int:r requests.get(fhttp://{ip}/api/api/get_play_queue_size, timeout3)return int(r.json()[data][data])def clear_queue(ip: str) - None:requests.get(fhttp://{ip}/api/api/clear_queue, timeout3).raise_for_status()**配图说明提纲 ⑦首页告警列表**截图设备 Web 首页告警列表标注“周期播报 / 循环播报 / 删除按钮 / 队列长度”。---## 九、通知组与灯效让“颜色级别”成为值班共识建议在博灵智能监控终端里预先建好通知组而不是每次 API 都裸传样式| 通知组 | LED | 语音 | 用途 ||---|---|---|---|| critical | 红转亮 | 开重复更高 | 宕机、断电、核心链路中断 || warning | 黄闪亮 | 开 | 阈值越界、磁盘将满 || info | 蓝脉动 | 可选 | 变更提醒、工单到达 || recovered | 绿常亮短时 | 开 | 故障恢复 |系统设置里还可配置- 全局 TTS 语速1~10- 在线/仅离线语音合成- 自定义提示音wav≤2MB最多 10 个- 声光免打扰按周- 待机样式呼吸、贪吃蛇、灯塔、火焰等**配图说明提纲 ⑧通知组编辑页**截图通知组编辑红框“重复播报次数 / 播报间隔 / 多层颜色 / 语音开关 / 提示音 / 免打扰”。---## 十、联调清单可直接当验收用例1. **网络**浏览器能打开设备管理页设备能 NTP 同步。2. **权限**API Key 已轮换签名开关与脚本一致。3. **启停**声光播报 API 已启用。4. **单次告警**send_msg 返回 200现场听到 TTS、看到转亮。5. **签名失败用例**故意改 time 超 120s确认被拒绝。6. **队列**连续推 5 条get_play_queue_size 递增clear_queue 后归零。7. **WebHook**从真实监控打一条 firing 一条 resolved。8. **日志**在「系统日志 → Api调用日志 / 播报日志」核对请求与播报记录。9. **备份**配置稳定后做一次备份还原演练。**配图说明提纲 ⑨日志页**左右分栏左 Api 调用日志含路径、状态码右播报日志文本、时间、通知组。---## 十一、常见坑省你半天1. **只配了 IP没开声光播报开关** → 接口可能通灯不响。2. **设备时间不准** → 签名 120 秒窗口直接失败。3. **JSON 序列化不一致** → 签名时 color/led_flag 的空格、引号要与实际提交一致。4. **TTS 文本过长** → 超长截断关键主机名放句子前部。5. **告警风暴无聚合** → 队列堆积现场噪音疲劳先做抑制再推终端。6. **生产仍用默认密码/默认 API Key** → 局域网内可被误触发务必修改。7. **跨网段无路由/无云服务** → 告警源根本打不到设备先做连通性。---## 十二、小结把“可见的监控”升级成“可感知的现场告警”如果你已经有一套 IT 信息化 / 运维监控系统缺的往往不是再多一个图表而是把告警变成**机房可感知的声光语音事件**。**博灵 Q 系列博灵智能监控终端 / 博灵语音通知终端** 的价值在于- 用标准 **HTTP API** 接入几乎所有告警源- 用 **API 签名** 保证调用可校验- 用 **自定义 API / WebHook** 兼容异构字段- 用 **全彩 LED TTS 语音播报 通知组 播报队列** 完成现场闭环- 需要时还能扩展到 **Modbus TCP、SNMP、Ping、邮件监控、云服务中继、阿里云短信**。建议落地顺序1. 单机 send_msg 跑通2. 通知组按级别固化3. 接一条真实 WebHook4. 再加队列治理与恢复告警5. 最后视情况上云服务或工业 Modbus。官方文档入口- 产品介绍https://eyegroup.cc/model-q/pro-desc/- 快速入门签名https://eyegroup.cc/model-q/quick-door/- 单次告警 APIhttps://eyegroup.cc/model-q/once-api/---## 附配图总提纲建议 9 张全平台通用| 序号 | 文件建议名 | 画面内容 | 图注文案 ||---|---|---|---|| 1 | 01-architecture.png | 监控→HTTP签名→博灵终端 | 监控告警到博灵语音通知终端的数据流 || 2 | 02-network-setup.png | 网络设置页 | 博灵Q系列首次配网与静态IP || 3 | 03-api-switch.png | API启停 | 启用声光播报后才能HTTP触发 || 4 | 04-sign-flow.png | 签名四步示意 | tokentime字典序MD5签名 || 5 | 05-postman-send-msg.png | Postman调send_msg | 单次声光告警与TTS联调 || 6 | 06-custom-api-map.png | WebHook字段映射 | 自定义API兼容异构监控回调 || 7 | 07-alarm-queue.png | 首页告警/队列 | 周期播报、循环播报与队列治理 || 8 | 08-notify-group.png | 通知组编辑 | 用颜色和语音表达告警级别 || 9 | 09-logs.png | API/播报日志 | 联调验收看系统日志 |---### 发布提示CSDN / 知乎等- 标题可直接用本文标题或改成更检索向HTTP API对接博灵语音通知终端签名算法send_msg声光TTS实战- 正文已按技术笔记结构写关键词密度高若平台提示广告属性在文首加一句“基于官方文档的对接实践/设备体验笔记”即可- 代码块保留便于过“技术文”审阅外链用官网文档避免站外引流过度 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
