CATALOG

民宿场景中,客人忘关门、入住退房权限切换不及时、门磁安装不便等问题频发,而芯步的开放接口恰好可以用“延时通断”这个能力来解决——通过一条带延时参数的HTTP命令,让门锁在指定时间后自动恢复状态。以下是具体方案:

解决方案:基于芯步开放接口的民宿门禁延时通断控制方案

一、 行业痛点与需求分析

在民宿运营中,门禁控制不仅需要基础的远程开锁功能,更核心的痛点在于“时效性”与“安全性的平衡”

  1. 超时滞留管理:客人退房后未离开,需要远程强制清场或限制出入权限。

  2. 防尾随/忘关门:客人进门后忘记关门,或门锁未锁死,存在安全隐患。

  3. 临时授权:保洁或维修人员需要在特定时间段内进入,且进入后权限自动失效。

  4. 自动化入住/退房:客人抵达前自动激活门锁权限,退房时间一到自动冻结。

利用芯步智能硬件的HTTP API接口及其特有的设备端延时执行(Reset/Point) 能力,可以在不依赖云端持续下发指令、不占用过多服务器资源的情况下,优雅地实现上述控制逻辑。

二、 硬件选型与角色定义

基于芯步产品线,推荐组合以下设备来实现门禁延时通断控制:

设备类型推荐型号角色与作用
门禁控制器智能墙壁出门开关 / 智能控制器4路核心执行器。控制电磁锁/电插锁的电源通断。支持“先断后通(Reset)”指令
身份验证终端智能密码门禁[触摸]前端交互。支持下发临时密码、永久密码,验证结果上报
环境传感器智能人体存在雷达传感器状态监测。探测房间内是否有人,防止误判,实现“人走断电”或“人未走勿锁”
门磁传感器门磁感应器状态反馈。检测门物理开/闭状态,确认延时指令执行后的实际效果。

三、 技术原理:设备端延时控制

传统的延时控制通常需要在云端设置定时任务(Cron Job),存在网络延迟依赖和任务堆积风险。芯步的方案通过在 order 指令中直接携带延时参数,由设备硬件本地计时执行,实现了 “下发即忘,到时即动” 的机制

关键API指令解析:

  1. reset (先断后通)

    • 逻辑:立即断开电源(开门),间隔 N 毫秒后自动恢复电源(锁门)。

    • 应用远程开门迎客。客服确认身份后,下发开门指令,门开 10 秒后自动锁闭,防止尾随。

    • 指令示例{"reset":10000} (立即断电开门,10秒后自动通电上锁)

  2. point (先通后断)

    • 逻辑:立即接通电源(锁门/保持),间隔 N 毫秒后自动断开电源(开门)。

    • 应用延迟退房控制。客人退房时间到,不是立即锁死把人关在屋内,而是比如 30 分钟后执行断电锁门。

    • 指令示例{"point":1800000} (保持门锁关闭状态,30分钟后自动断电开门)

  3. keep & revert (状态保持与恢复)

    • 逻辑:锁定当前状态一定时间,期间用户手动操作无效,时间过后恢复。

    • 应用深度清洁模式。保洁期间保持门常开,时间结束后自动恢复安全门禁状态

四、 具体实现方案与业务流程

1. 环境搭建与对接准备
  • 硬件安装:在民宿门口安装芯步智能墙壁出门开关(86盒替换原有开关)连接12V电磁锁。同步安装智能密码门禁作为输入设备。

  • API对接准备

    • 在芯步控制台获取 AppIDAppSecret

    • 配置PMS(民宿管理系统)或小程序后端,调用API域名:http(s)://api.thingboot.com/{AppId}/device/control/

2. 典型场景方案
场景A:客人自助入住与“延时退房”管控
  • 需求:客人线上预订后,获得一个有效期为入住当天12:00至次日14:00的开门密码。

  • 控制流

    1. 下发限时密码:PMS系统调用 add_password 接口,向门禁设备写入密码,并附带有效期参数(如有效期至次日14:00)。

    2. 延时退房逻辑:若客人购买延时服务或作为权益赠送,系统在次日14:00时,不发送“锁死”指令,而是发送 point 指令。

      • 指令:{"point": 3600000} (1小时后执行开门动作)。

      • 效果:客人在14:00-15:00之间仍可正常出入;到了15:00,设备自动断路(开门),此时密码权限已同时失效,客人无法再入内,实现了软性清退

场景B:远程安全检查与“防忘关门”机制
  • 需求:客人退房后,保洁发现门没关紧,或者客人出门后未锁门。

  • 控制流

    1. 传感器检测到门磁处于“开启”状态超过5分钟。

    2. 管家手机收到告警,点击“关锁”。

    3. 系统调用 reset 指令。

      • 指令:{"reset": 500} (先瞬间断电一下(瞬间复位电磁锁),500毫秒后重新通电)。

      • 效果:这一瞬间的断电会让电磁锁失去吸力,锁舌在弹簧作用下弹出,门体在未拉动的情况下也会物理锁死。这就是“延时通断”在安全闭环中的妙用。

场景C:与人体传感器联动的“节能/安全模式”
  • 需求:防止客人已退房但忘了关大门(虚掩),或防止儿童误开门跑出。

  • 联动逻辑

    1. 门禁控制器执行 power 指令开门。

    2. 雷达传感器探测到“有人持续存在”。

    3. 延迟强锁:无论密码是否正确,系统在无人进出5分钟后,发送 reset 指令强制复位门锁状态。

五、 接口调用与代码实现示例

以下是基于芯步API实现“先断后通”(延时关门)的核心代码逻辑(伪代码/概念演示)。利用芯步极为简单的签名机制,只需将 AppSecret 进行MD5嵌套拼接时间戳即可

场景:管家APP点击“远程开门(10秒后自动锁)”

代码解读

  • "reset":5000 这一行是整个方案的核心。相比传统的“下发关锁指令”,这里实现的是一个连续状态变化,且由于计时是在设备芯片本地完成,即使网络抖动或服务器宕机,在5秒后门锁依然会自动上锁,极大提高了安全性

六、 总结

  1. 低成本改造:利用芯步86型标准入墙式设备,可直接替换现有开关,无需重新布线,完美适配老旧民宿改造

  2. 高可靠离线执行:即使民宿的Wi-Fi出现波动,设备在执行 resetpoint 指令的延迟期间,依然会坚持完成动作,不会因断网而“一直开着门”或“一直锁着门”。

  3. 极速响应:接口调用响应时间仅为 80-120ms,配合设备端延时,用户体验无延迟感

  4. 开发友好:仅需 HTTP POST 请求,即便是小型民宿 SaaS 服务商或个人开发者,也能在 10 分钟内完成对接

通过上述方案,民宿管理者可以利用芯步的开放接口,将传统的静态门禁升级为具备“时间感知”能力的智能安防系统,彻底解决因人为疏忽导致的安全漏洞。