共享设备柜的痛点是“多路独立控制”——每个格口需要单独供电、计费和断电。芯步的8路智能控制器正好解决这个问题,通过HTTP接口即可实现每路独立控制,无需网关、部署简单。以下是完整的集成方案。
1. 解决概述
在共享经济场景(如共享充电宝柜、共享雨伞机、快递柜、工具租赁柜)中,核心需求是:远程控制单个格口的通电与断电,并结合扫码支付实现自动化运营。
芯步提供的 8路智能远程电源控制器 专为此类场景设计。它拥有8个独立可控的线路,支持通过简单的 HTTP/HTTPS 接口远程控制每一路的通断。这意味着你可以将一个拥有8个格口的柜机物理上仅需一块控制器即可实现独立控制,极大降低硬件成本和布线复杂度 。
核心价值:
高集成度:单设备控制8路输出,适合标准柜体布局。
独立控制:8路分控互不干扰,可独立控制对应格口的电源或电磁锁。
开发友好:开放标准 HTTP API,无论你的后台是 PHP、Java、Python 还是 Go,均可轻松集成。
部署灵活:支持 公网远程控制 和 局域网私有化部署,保障数据安全与响应速度 。
2. 硬件选型与准备
在集成前,请确认你的硬件设备为 UNI-KZQ-TY-8 系列(智能通用控制器 | 8路)。
关键参数说明:
工作电压:DC 12V 1.5A(需配备稳定电源)。
负载能力:单路最大支持 2200W(阻性负载),总功率不超过 4400W。
通讯方式:WiFi 2.4GHz(不支持 5G WiFi,需注意现场路由器频段设置)。
控制方式:继电器输出。对于共享设备柜,通常用于控制 220V 电源插座 或 12V 电磁锁。
接线示意(与柜体的物理集成):
输入:控制器接入 220V 市电或 12V 直流电源。
输出(8路) :
L/N 输出端子:分别连接到 8 个独立格口的电源插座(例如 220V 充电插座)。
或者连接到门锁驱动板。
网络:配置连接至现场的 2.4G WiFi。
3. 设备端配置(配网与激活)
在进行 API 开发之前,需要先将设备连上网络并与你的平台账号绑定。
操作步骤:
注册/登录:访问芯步官网或小程序,注册企业账号。
创建“工作台”:这是管理设备的数据核心。
配网
使用 “小程序配网” 较为便捷。
进入小程序后,选择对应的工作台,输入现场的 2.4G WiFi 名称和密码。
控制器接通电源,待指示灯从“快闪”变为“常亮/慢闪”,即表示上线成功。
获取关键凭证
登录物联网控制台,找到已配网的设备,记录 设备ID(Device ID)。
进入“开发设置”,获取 AppID 和 AppSecret(开发者密码)。这 3 个字符串是后续 API 调用的钥匙 。
4. API 接口集成指南
芯步的接口采用标准的 HTTP POST 请求,请求体为 JSON 格式,签名算法简单通用。
4.1 接口地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
注:支持 HTTP 和 HTTPS,若部署在局域网内可使用私有化 IP 地址。
4.2 签名生成规则(核心安全步骤)
为了防止接口被恶意调用,请求需要携带动态签名。
公式
sign = md5( md5(AppSecret) + ts )参数说明
AppSecret:你的开发者密码。ts:当前 UNIX 时间戳(秒),用于防止重放攻击。
PHP 示例:
4.3 控制指令详解
该 API 支持非常精细的控制,以下是共享柜机场景最常用的指令。
| 操作场景 | 指令格式 (JSON String) | 说明 |
|---|---|---|
| 开第2个格口 | {"power2":1} | 1代表接通/开锁,0代表断开/关锁。 |
| 关第2个格口 | {"power2":0} | 控制在对应设备下 ID 为2的线路。 |
| 全开/全关 | {"batch":{"power":1}} | 一次性打开或关闭所有8个格口。 |
| 选择性批量 | {"batch":{"relay":[1,3,5,7],"power":1}} | 只打开 1,3,5,7 号格口。 |
4.4 代码实战(以 PHP 为例)
假设用户刚刚扫码支付成功,需要为用户打开 3 号格口:
注:其他语言(Java, Python, Node.js)逻辑完全一致,仅需替换 HTTP 请求库即可。
5. 业务逻辑集成(共享流程)
如何将控制器无缝集成到你的共享项目中?典型的“扫码-通电-断电”闭环如下:
步骤 1:用户扫码
用户扫描柜体上的二维码,前端获取设备编号(关联后台的柜机 ID 和格口号)。
步骤 2:支付与鉴权
你的后端服务器收到请求,调用支付接口(微信/支付宝)。
支付成功后,进入控制逻辑。
步骤 3:下发指令
你的业务服务器调用芯步 API。
请求示例:针对
device_001发送{"power3":1}。硬件响应(通常在 100ms 以内),继电器吸合,3号格口通电/弹开电磁锁 。
步骤 4:状态监控与心跳
被动上报:用户归还物品关闭柜门(或通过物理限位开关),你可以在业务上主动调用
{"power3":0}切断电源,确保安全。联动控制:用户可以结合芯步的 传感器类产品(如门磁传感器)。当检测到柜门关闭时,自动触发 API 调用切断电源并结束计费 。
6. 私有化部署与局域网控制
对于网吧、企业内部、政府机构等高安全或低延迟要求的场景,芯步支持 私有化部署。
无需云端:指令完全在本地局域网路由内传输,不经过芯步公网服务器。
更低延迟:局域网内响应速度可达毫秒级,网络抖动极小。
独立生态:API 接口调用逻辑不变,只需将请求 URL 中的
api.thingboot.com替换为你部署的本地服务器 IP 即可 。
7. 注意事项与调试
1. WiFi 稳定性是关键
由于设备仅支持 2.4G,请确保现场路由器开启 2.4G 频段,并关闭“双频合一”功能,防止设备掉线 。
2. 负载类型注意
如果控制的是电机(如自动门)、LED 节能灯或开关电源,属于感性/容性负载,降额使用,否则可能损坏继电器触点 。
3. 设备唯一ID
如果管理 100 台柜机(每台一个控制器),你需要维护一个映射表:
本地格口ID->(Device_ID, Relay_Channel_ID)。
4. 调试工具
在正式编码前,先在芯步的“物联网控制台”网页端找到设备,尝试点击控制按钮。如果网页端能控,代码不能控,99% 是 签名算法错误(检查 AppSecret 是否多空格)或 ts 时间戳差值过大。
通过以上步骤,你可以将芯步的 8 路控制器作为一个标准的“外设”快速集成到你的共享系统中,实现硬件的智能化管理。