CATALOG

芯步的16A智能插座开放了HTTP接口,可以通过简单的API调用实现远程通断控制。下面我会从接口地址、签名规则、具体命令格式到代码示例,帮你理清整个接入流程。

解决方案:通过HTTP接口远程控制芯步16A智能插座

1. 准备工作

在开始敲代码之前,我们得先做好一些准备工作,把“钥匙”拿到手:

  1. 硬件上电:把你的16A智能插座插上电(注意这个插座一般是用来接空调、热水器这种大功率电器的,别插错了),等待指示灯进入慢闪状态(通常是配网模式)。如果是新设备,需要用官方App或配网工具让它连上家里的2.4G WiFi

  2. 获取凭证

    • AppID:登录芯步开放平台后台,在控制台就能看到你的应用ID。

    • Device ID:这是设备的唯一身份证,可以在设备外壳标签上找到,也可以在后台的设备列表里查到

    • Sign & Ts:这是接口安全验证的凭据(签名和时间戳)。

小提示:芯步的接口非常开放,支持任何能发起HTTP请求的编程语言。不管你是用Java、Python、PHP还是Node.js,甚至是低代码平台,都能轻松对接

2. 接口地址与鉴权

接口的请求地址格式如下(注意区分正式环境与测试环境):

  • {AppID}:替换成你的应用ID。

  • {ts}:当前的时间戳(Unix时间戳,单位为秒或毫秒,需看具体文档要求)。

  • {sign}:签名值。通常是按照一定的参数排序规则,结合 AppSecret(应用密钥)进行MD5或哈希计算得到的,这个需要严格按照平台的签名算法来生成,直接照搬代码是跑不通的,但逻辑很简单,后台也有自动生成示例的功能

3. 核心功能开发实战

这一节我们直接来看怎么“开”和“关”。这里以最通用的 cURL 命令行(适合Linux运维或后端调试)和 Python(适合绝大多数后端开发)为例。

3.1 下发控制指令(开关/关)

通过 POST 方式,向接口发送 JSON 数据包。

Python 代码示例:

注意:如果你习惯用命令行,直接用 curl 也很爽

3.2 读取电量计量数据

既然你选了计量版(型号带 -P 后缀,如 UNI-CZ-16A-P),光控制通断就太浪费了。我们可以通过接口读取电压、电流、功率数据来做能耗分析

特别说明:控制指令是发出去的,但实时数据(电压/电流)通常是设备主动上报的,而不是你主动去“拉”的。你需要在后台配置“消息推送”地址,设备每变化一次(比如功率跳动了),芯步平台就会把数据 POST 到你指定的服务器地址上。

上报的数据格式参考:设备回调给你的服务器时,POST Body 里大概会长这个样子:

你可以把这些数据存进数据库,用来画图表或者做自动控制(比如功率超过2500W自动断电)。

3.3 高级功能:定时通断与点动

有时候我们不想简单的开或关,而是想“让它运行5分钟后关”,这个接口也直接支持,不需要你在服务器上写定时任务,云端下发一次指令就行。

  • 场景:喂宠物/临时散热想要插座接通电源,但5分钟后(5000毫秒)请一定要自动关闭,防止干烧或忘关。

  • 场景:重启路由器想要断开电源,等几秒钟再重新接通(复位功能)。

这种方式对服务器来说非常友好,只用发一次指令,不需要维护一个定时任务队列来轮询

4. 注意事项与踩坑经验

  1. 关于返回码 200当你调用接口返回 {"code":200} 时,只代表芯步的云端服务器收到了指令并且下发了,不代表你的空调已经开了。如果插座当时断网了(比如WiFi信号不好),云端也是200。需要确认设备是否成功执行,监听设备回馈的消息推送

  2. 16A 插座的特殊适配再次提醒,16A的插孔和10A的普通插孔不一样(孔心距更大),如果你的电器插头是10A的(普通三脚插),强行插是插不进去的,可能需要一个转换头或者剪线更换插头。当然,用来控制3匹以下的空调是直接匹配的

  3. 局域网与私有化如果你是在工厂、内网环境使用,不希望经过外网,芯步这套东西是支持纯局域网控制的。只要你的服务器和插座在同一个网段,直接把 api.thingboot.com 替换成你自建的本地服务器地址就行,延迟能降到10ms以内,断网也能用。

  4. 批量控制如果你想一键关闭所有空调,device 字段支持传多个ID,用逗号隔开就行,例如 “device”: “123456,789012”

5. 总结

接入芯步的16A插座,其实就是对着它的 API 文档发几个 POST 请求的事儿。

  • 开/关:用 order: {“power”: “1/0”}

  • 计量:配置回调地址接收 voltage/current 数据。

  • 定时:用 pointreset 参数替代本地定时器。

这种模式很适合做能耗监测系统、远程空调控制或者共享洗衣机(扫码通电)之类的场景,开发起来还是挺快的。