无人值守门禁照明场景：如何将云平台控制墙壁开关集成到自己的项目中_解决方案

CATALOG

芯步的智能墙壁开关开放了HTTP接口，签名验证简单，响应也快，很适合做无人值守场景的二次开发。下面结合接口文档，聊聊怎么把它集成到自己的项目里。

这个方案的硬件是“智能墙壁开关”。它可以直接替换家里或园区里传统的86型墙壁开关，不用重新布线，直接替换就能把普通灯变成联网灯。

对于开发者来说，芯步的这套开关最吸引人的地方是开放了全功能的HTTP接口。这意味着，不管你的后端是用Python、Java、PHP还是Go写的，甚至是在微信小程序里，只要能和互联网通信，发出HTTP请求，就能让这个开关“啪”的一下把灯打开或关掉。

要把这个开关集成到你的无人值守项目里，核心其实就是搞定那个设备控制接口。听起来挺专业，其实就像是在代码里发一条指令。

在芯步的开发者后台，你能拿到两个字符串：AppID 和 AppSecret。

这是唯一有点绕的地方。为了安全，每次发命令都要做一个“签名”。公式是这样的Sign = md5( md5(AppSecret) + ts )

举个例子（伪代码）：

把这个 sign 和 ts 带上，平台才知道这条指令是合法的，不是黑客在搞破坏。

准备好参数后，就可以直接往这个地址“扔”数据了

请求地址https://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={时间戳}
请求方式POST
请求 Body

这段代码的意思就是：把 ID为820720 的那台开关的 第1路（power1） 打开（1代表开，0代表关）。

这就完成了集成最核心的一步：你的后端服务器已经可以控制灯光的亮和灭了。

既然已经能控制了，我们来搭建一下“无人值守门禁照明”的完整逻辑。这个场景的精髓在于：人来了，灯要亮；人走了，灯要灭；半夜没人，灯绝不能自己乱亮。

门禁系统（刷卡/人脸识别） -> 触发事件 -> 你的业务服务器 -> 调用芯步云接口 -> 智能墙壁开关 -> 灯光亮起

第一种场景：人员进入，灯光预热（解决摸黑问题）当有人刷卡或人脸识别成功时，你的服务器应该立刻给开关发指令。

第二种场景：延时自动关灯（省电核心）这是无人值守最实用的功能。人进去了，灯一直亮着多浪费电啊。

需求：人进去后，检测到门关上，或者5分钟没有人体移动信号，自动关灯。
实现的方式是利用智能开关的 “先通后断” 功能，也就是 point 命令。
// 让灯亮，但是10分钟后（600000毫秒）自动熄灭 {"device":"Device_01", "order":{"point1": 600000}}
这条命令会立即接通电路（亮灯），并开始倒计时，时间到了自动断开（熄灯）。你的服务器甚至不需要去记这个计时器，开关自己就帮你把事办了，非常省心。

第三种场景：夜晚模式的“微光”或“延时响应”如果是仓库门口，晚上不希望太亮刺眼，或者只是在找钥匙需要短时间照明。

场景四：状态查询（运维必备）有时候你需要知道灯到底开着没。

需求：想在管理后台看到“当前灯光状态”。
实现的方式是调用获取设备详情接口。
- 地址https://api.thingboot.com/{AppID}/device/info/...
- 返回参数：注意看 state 里的 power1，如果是 "1" 就是开，"0" 就是关。顺便提一句，返回的数据里还有 online -> status，如果等于0，说明设备掉线了，这也可以作为故障告警的依据。

我在对接的时候遇到过这几个问题，提前说出来能帮你省下至少一下午的调试时间：

签名用MD5，直接传就行：接口采用的是双重MD5加密，而且直接用参数传，不是什么复杂的JWT或OAuth。只要注意时间戳 ts 是秒级（10位数）而不是毫秒级（13位数）就行。
局域网控制优先（零延迟体验）：如果你的门禁服务器和这个开关在同一个局域网里，优先使用局域网控制方式。直接给开关所在的局域网IP发命令，延迟可以从互联网的100-150ms降到10ms以内，几乎感觉不到延迟。这时请求地址就变成了：http://192.168.1.xxx/control，数据格式不变。
多路的控制：如果买的是两路或三路开关，记得看清楚 power1 接的是哪个灯。如果是双开，要同时开灯，代码写成：
{"order": {"power1":1, "power2":1}}