对于有开发能力的团队，信息发布系统不只是一个"装上就用"的软件，还可以通过API接口和中控协议进行二次开发和系统集成。本文介绍系统能提供哪些开发接口，以及常见的集成场景。

一、为什么要二次开发

标准的管理端APP已经能覆盖大部分使用场景，但有些业务需求需要更深度的集成：

• 把设备状态接入自己的运维监控大屏
• 对接OA系统，自动发布审批通过的通知
• 对接叫号系统，屏幕自动显示排队信息
• 对接IoT传感器，根据环境数据自动切换内容
• 用AI Agent自动化巡检和管理

这些场景需要系统提供开放的接口。

二、系统能提供哪些接口能力

1. HTTP API

系统提供HTTP接口，第三方系统可以通过标准的HTTP请求获取数据和执行操作：

• 查询设备列表和状态
• 查询节目信息
• 查询投放关系
• 执行设备控制指令

适合需要将信息发布系统集成到现有IT系统的场景。

2. 中控协议

提供两种设备控制方式：

方式	特点	适合场景
服务器转发RPC	通过服务器转发指令，支持跨网段	远程管理、跨网络控制
UDP直连	局域网内直接向设备发指令，延迟低	现场中控、实时控制

两种方式使用统一的JSON命令格式，开发者可以灵活选择。

3. MCP Server

系统内置MCP（Model Context Protocol）Server，支持Claude Code、Codex等AI Agent接入：

• Agent可以查询设备状态
• Agent可以查看节目和投放关系
• Agent可以辅助日常巡检

这是目前数字标牌行业较少见的AI Agent集成能力。

三、常见集成场景

场景1：对接叫号系统

叫号系统 → 中控协议 → 显示端
                    → 屏幕自动显示当前叫号

通过UDP直连或HTTP RPC，将叫号信息发送到显示端，屏幕自动更新叫号内容。适合医院、银行、政务大厅。

场景2：对接IoT传感器

人体感应传感器 → 触发中控指令 → 显示端切换到欢迎页面
                                → 无人时切换到屏保

适合展厅、门店入口等需要"人来即播"的场景。

场景3：对接运维系统

信息发布系统 → HTTP API → 企业运维平台
                        → 设备状态大屏
                        → 异常报警

将设备在线状态、节目播放状态接入企业现有运维平台，统一监控。

场景4：AI Agent巡检

运维人员 → Claude Code → MCP Server → 信息发布系统
                                    → "列出所有离线设备"
                                    → "检查这个节目投放到哪些设备"

用自然语言查询设备状态，替代手动翻管理端页面。

四、开发接入流程

1. 获取API文档：联系系统提供商获取完整的API文档和接口说明
2. 获取认证Token：在管理端获取JWT Token用于接口鉴权
3. 测试接口：先用Postman或curl测试接口调用
4. 开发集成：在自己的系统中调用API或中控协议
5. 部署上线：完成集成测试后部署到生产环境

五、注意事项

• API调用需要Token认证，不同Token对应不同权限
• UDP端口不要暴露到公网，仅限局域网使用
• 敏感操作（重启、恢复出厂）需要确认机制
• 接口调用频率需控制，避免对服务器造成压力
• 建议先在测试环境验证，再部署到生产

六、总结

信息发布系统不只是"装上就用"的软件，通过API、中控协议和MCP Server，可以深度集成到企业现有的IT系统中。如果你有开发能力，这些接口能帮你实现自动化运维、系统对接和智能管理。