芯步的门禁硬件通过统一的HTTP接口开放控制能力，从出门开关到密码门禁均可远程调用。以下方案涵盖设备选型、接口对接、联动逻辑到私有化部署的全流程，开发者可在此基础上快速构建自定义门禁系统。
1. 概述
本方案的目标是指导开发者或系统集成商，利用芯步开放的 HTTP API 接口，将智能门禁硬件（如出门开关、密码门禁、包间控制器）快速对接到现有的第三方系统中（如酒店 PMS、共享空间 SaaS、企业内部 OA）。
通过该方案，您可以实现远程开门、多设备联动（开门即开灯/关空调）、动态密码管理以及设备私有化部署，确保数据安全与响应速度。
适用场景：
共享棋牌室/茶室/影院的无人值守管理
企业办公区域的门禁考勤联动
公寓/酒店远程密码下发与房间控制
2. 硬件选型与功能
在开始对接前，请根据应用场景选择合适的门禁硬件。芯步的系列产品均支持标准化的接口调用。
| 产品类型 | 核心功能 | 典型应用场景 | 接口特征 |
|---|---|---|---|
| 智能出门开关 | 控制电磁锁通断，支持“先断后通”自动复位 | 房间大门、办公室门 | 单一继电器控制，接口简单 |
| 智能密码门禁 | 支持HTTP下发/删除密码，含永久与时效密码 | 共享空间、短租房、仓库 | 需处理密码列表管理 |
| 智能包间控制器 | 集成了门禁+灯光+空调+音响的多路控制 | 共享棋牌室、茶室、KTV | 多路继电器，支持批量控制 |
选型：如果仅需解决“进门”问题，使用“出门开关”+“电磁锁”成本最低且最稳定。如果需要实现“扫码获取密码进入”，请选择“智能密码门禁”。
3. 接口对接准备工作
在编写代码前，完成以下账号与环境的配置，整个流程大约需要 10分钟。
注册与登录：访问芯步官网并注册账号。
获取密钥
进入控制台 -> 「物联网控制台」-> 「开发设置」。
获取 AppID（开发者ID）和 AppSecret（开发者密码）。
注：开发测试阶段可开启“调试模式”以暂时绕过签名校验，简化前期测试。
设备配网
将购买的设备通电。
使用官方小程序或电脑控制台，为设备配置现场的 2.4G WiFi 网络。
获取设备ID：在控制台的“设备列表”中，查看并记录下设备的唯一标识符（Device ID）。
4. 核心接口调用详解
芯步的接口设计遵循 RESTful 风格，通过向指定 URL POST 一个 JSON 字符串即可完成控制。从命令下发到设备响应约为 80-120ms。
4.1 请求地址与签名计算
接口地址如下（支持 HTTP 与 HTTPS）：http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
为保证安全性，请求需携带 sign（签名）和 ts（时间戳）。
签名算法
sign = md5(md5(AppSecret) + ts)
4.2 控制智能出门开关（开门/关门）
需求：按下开门按钮或远程开门，电磁锁断电3秒后自动吸回。命令示例：发送 {"reset":"3000"} 或 {"power":"1"}。
代码示例（Python）
4.3 智能密码门禁（动态密码下发）
需求：为访客生成一个仅在今晚 20:00-22:00 有效的密码。命令示例{"pwd":"123456#", "effect_time": 1698768000, "expired_time": 1698775200}。
逻辑说明
调用接口设置密码，需指定生效和失效的时间戳。
用户在门禁上输入密码。
门禁设备本地验证密码有效性（支持离线验证），验证通过后开锁，同时向服务器上报开门记录。
4.4 高级联动控制（以包间控制器为例）
场景：用户下单成功 -> 系统自动开门 -> 房间通电（空调/麻将机启动）-> 语音播报“欢迎光临”。
由于“智能包间控制器”集成了门禁和电源控制，只需一次调用即可控制多个线路
5. 系统联动实现逻辑
为了实现“门禁感应开关”与业务的联动，采用 Webhook 回调机制 或 轮询机制。
触发源：当用户通过物理按键、小程序或管理后台点击“开门”时，您的业务服务器接收到指令。
业务校验：您的服务器校验用户权限（如订单是否有效、押金是否充足）。
下发指令：校验通过后，调用芯步 API 向指定设备发送
control命令。状态同步（推荐） ：
如果设备状态变化需要实时反映到系统（如有人暴力撬锁），配置自建消息服务器。
设备支持 MQTT 协议（地址：
mapi.thingboot.com）或 HTTP 回调，将门磁开关信号实时推送给您的服务器。
6. 私有化部署与内网控制
对于安全性要求比较高或网络环境较差（无外网）的场景，芯步支持 私有化部署。
方案：在局域网内的 PC 或服务器上安装“芯步软网关”。
效果：设备自动发现并注册到局域网网关。您的业务系统只需调用内网地址（如
http://192.168.1.100/control）即可控制门禁，数据完全不经过外网，保障了数据传输的极低延迟（<10ms）与安全性。
7. 注意事项与排错
网络频段：所有设备仅支持 2.4G WiFi，配网前请确认手机及路由器设置。
电磁锁选型：支持 DC12V 的电磁锁或电插锁，请勿直接接入 220V 强电。
接口限频：单个设备访问限制为 1次/秒，请勿在循环中无延迟高频调用，以免被限流。
签名错误：确保时间戳（ts）为中国时区（CST）且单位是秒（10位数字），并确认
md5结果为32位小写字符串。调试工具：先使用 Postman 配合“调试模式”（忽略签名）测试设备连通性，成功后再切换到生产模式进行签名开发。
通过以上步骤，开发者可以快速利用芯步的开放接口，将普通的物理门禁升级为可远程控制、可编程联动的智能门禁系统。如果您在对接过程中遇到具体技术问题，芯步官方提供全程技术指导支持。