门禁插座HTTP接入
简介
门禁插座协议（mjcz）是联犀平台对接明景门禁/插座第三方平台的 HTTP 通知接入协议。第三方平台通过 HTTP POST 主动推送设备状态到协议网关，协议网关转换为联犀标准物模型消息。
应用场景
- 明景门禁：门禁设备状态、开关门事件上报
- 明景插座：插座用电状态上报
前置条件
- 协议容器已部署：
protocol-mjcz容器运行正常 - 回调地址可达：第三方平台能访问协议网关的回调地址
- 进程级配置：
MjBaseURL/CzBaseURL/AppKey/AppSecret（协议进程配置，非页面配置）
设备接入
进入设备详情「设备接入」Tab，页面展示回调地址：
| 回调 | 地址 | 说明 |
|---|---|---|
| 门禁 | http://{host}/api/v1/mj | 门禁状态推送 |
| 插座 | http://{host}/api/v1/cz | 插座状态推送 |
第三方平台需将门禁/插座状态事件 POST 推送到对应地址。
技术方案
接入架构
明景第三方平台 ──HTTP POST──> protocol-mjcz 容器(/api/v1/mj、/api/v1/cz) ──MQTT/NATS──> 联犀平台- 第三方平台在门禁/插座状态变化时 POST 到对应回调地址
- 协议网关按
type区分操作（门禁/插座），解析设备状态 - 上报设备上下线（
ReportDevConn）与物模型属性
消息流转
- 上行：第三方平台推送 → 协议解析 → 联犀设备状态/属性
- 下行：联犀控制指令 → 协议调用第三方平台 API（MjBaseURL/CzBaseURL）→ 设备执行
注意事项
- 回调地址为协议进程对外暴露的 HTTP 端口
- 第三方平台需配置好 AppKey/AppSecret 鉴权
- 门禁/插座的产品 ID 在协议中固定（门禁 65、插座 66），需与联犀侧产品对应
更新日志
2026/8/20 21:56
查看所有更新日志
70f71-于
