芯步的10A 86型智能插座提供标准HTTP接口,可在局域网或公网环境下通过POST请求直接控制。以下方案涵盖从签名鉴权、指令下发到状态反馈的完整对接流程,所有代码示例均可直接复制使用。
一、 对接前的准备:获取凭证与设备ID
在开始编码之前,你需要在芯步开发者后台获取以下三个关键信息,这通常只需要5分钟:
AppID (应用ID):用于标识你的应用/项目。
AppSecret (应用密钥):用于生成签名,确保API调用安全。
Device ID (设备ID):即具体你要控制的那个10A墙壁插座的唯一标识(可在控制台设备列表查看,通常为数字串)。
二、 接入流程:HTTP API 调用实战
芯步的接口设计遵循RESTful风格,无论是Web、APP还是小程序,均可通过通用HTTP请求完成对接。
1. 接口地址与鉴权机制
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方法
POSTContent-Type
application/json
鉴权参数计算规则(非常重要)为了防止接口被恶意攻击,请求需要携带动态签名。签名的生成算法如下(以通用伪代码/Python为例):
核心原理即为:sign = md5( md5(AppSecret) + ts )。
2. 控制指令下发(开门/关门/点动)
将10A插座接入项目系统,核心在于发送order指令。根据餐厅场景,主要分为以下几种控制模式:
| 场景模式 | 指令描述 | JSON指令示例 | 适用说明 |
|---|---|---|---|
| 常开/常关 | 开启插座 | {"power":1} | 基础开关,控制设备持续供电或断电 |
| 点动模式 | 先通电后断电 | {"point":"3000"} | 取餐叫号器触发:瞬间通电,3秒后自动断电,防止电磁阀烧毁 |
| 断电复位 | 先断电后通电 | {"reset":"3000"} | 冰箱/冰柜保护:断开3秒后重新通电,实现设备重启 |
| 能耗统计 | 读取数据 | {"metering":1} | 获取电压、电流、功率,用于营业数据参考 |
Python代码接入示例 (Flask/Django通用) :
三、 典型餐厅场景方案设计
结合10A智能插座接口,我们可以在你的项目中实现以下两个核心功能模块:
1. 智能定时与无人值守
餐厅打烊后常忘记切断设备电源(如展示柜灯光、收银机屏幕)。你可以利用接口配合服务器的定时任务(如crontab或Scheduler):
实现逻辑:在项目中设定
22:00执行脚本,调用上述API,发送{"power":0}给【大厅展示区】对应的插座。节能统计:调用
metering接口记录每日能耗,生成报表作为餐厅节能减排的量化数据。
2. “餐桌呼叫-取餐联动” 点动控制
对于西式快餐或自助火锅店,当后厨出餐完毕,服务员按下按钮时,需要让指定的餐位桌牌或震动提醒器通电一瞬间并复位。
实现逻辑
调用
{"point": "2000"}(通电2秒后自动断开)。优势:这种模式不需要在业务代码中维护任务队列来关闭开关,插座硬件本身在通电2秒后会自动切断,保证了系统的稳定性和网络不拥塞 。
四、 高级功能与数据监控
除了控制通断,你的项目还可以对接插座的上行数据,让系统更“聪明”:
状态实时同步:通过芯步提供的消息推送服务(Webhook),当有人在餐厅本地按了插座上的按钮,平台会主动推送状态变化到你的服务器,实现App与物理按键状态的实时同步 。
过载保护:当接口返回的功率数据超过插座额定值(10A插座通常为2200W)时,你的系统可以自动触发断电指令,保护餐厅老旧线路的安全 。
五、 总结
将芯步10A 86型插座接入你的项目只需三步:获得凭证 -> 计算签名 -> 发送POST请求。该方案的优点是全兼容性(HTTP协议支持任何编程语言)和低侵入性(无需复杂的SDK,直接调用API即可)。对于餐厅而言,这不仅是简单的开关控制,更是实现能耗管理、自动化运营和提升用电安全的硬件基础。