芯步的8路控制器开放标准HTTP API，无论你用Python、Java还是前端JS，几行代码就能把继电器开关集成到自己的系统里。下面前两部分讲清楚技术对接怎么做，后面补充了选型对比和应用案例。
一、 背景与选型
在创客项目或行业应用中，设备电源控制通常面临两个痛点：电路改造复杂和缺乏统一的软件接口。芯步的8路智能远程集中控制模块正是为了解决这些问题而设计的。
目前芯步有两款主流的8路控制器，你需要根据项目供电环境进行选择
| 特性 | UNI-KZQ-AC-8 （交流市电版） | UNI-KZQ-TY-8 （直流版） |
|---|---|---|
| 适用场景 | 家庭、办公、自习室、售货柜 | 沙盘模型、汽车电路、实验装置 |
| 工作电压 | 85-265V AC （直接接220V市电） | 12V DC （需要电源适配器） |
| 负载类型 | 直接控制灯泡、接触器、插座 | 控制12V LED、电磁阀、小功率电机 |
| 接口协议 | HTTP / MQTT | HTTP / MQTT |
| 优势 | 免电源，直接接零火线，适合改造 | 低压安全，体积更紧凑（95*80*65mm） |
选型：如果你的项目是控制220V的家电或照明，请选择 AC版；如果是控制单片机项目、模型灯光或12V设备，请选择 TY （DC） 版。
二、 核心技术对接方案
该产品的最大优势是开放了完整的 HTTP API接口，这意味着你无需关心底层无线通信（WiFi透传），只需通过简单的网络请求即可控制设备。以下是接入你项目的具体技术细节：
1. 环境准备与网络配网
账号注册：在芯步官网注册开发者账号。
设备配网：使用官方的小程序或“物联网控制台”给8路控制器配置2.4G WiFi。成功联网后，设备会在云端上线，你可以在后台获取到唯一的 设备ID （Device ID）。
2. API 接口调用详解
芯步的接口设计非常简洁，支持GET和POST方式。所有请求都需要通过 {AppID} 和动态签名（Sign）进行身份验证。
请求地址
http（s）://api.thingboot.com/{AppID}/device/control/？sign={sign}&ts={ts}核心参数解析在向该地址发送请求时，你需要携带以下核心参数
device必填。你在控制台获取到的8路控制器设备ID。order必填。这是控制指令，JSON格式。对于8路控制器，指令集非常标准，如下表所示。
3. 指令集定义（重点）
你可以通过改变 order 参数来独立控制任意的继电器通断 。
| 功能描述 | 指令示例 （JSON） | 说明 |
|---|---|---|
| 控制第1路开启 | {"power1":"1"} | 1代表开，0代表关 |
| 控制第3路关闭 | {"power3":"0"} | |
| 控制第8路开启 | {"power8":"1"} | 支持1-8路独立控制 |
| 全部开启 | {"power":"1"} | 控制所有通道 |
| 全部关闭 | {"power":"0"} | 控制所有通道 |
| 点动模式 | {"point1":"1000"} | 第1路通电1秒后自动断开 |
4. 代码嵌入示例
无论你使用什么编程语言，只需发送HTTP Request即可。以下展示如何在你项目的后端或Python脚本中集成。
Python 实现（Flask项目或脚本）：
三、 应用场景指南
将上述API集成到你的项目中后，可以扩展出以下典型功能：
电子沙盘/模型控制
在展览模型中，利用 DC 12V版 直接控制模型灯光或马达。
将API接入触摸屏软件，点击屏幕即可通过HTTP请求控制对应区域的灯光亮起，无需复杂的布线 。
共享设备/自习室
利用 AC版 控制自习室的电源插座。
在用户下单支付成功后，你的后端服务器自动调用API中的
{"power3":"1"}为该用户分配的路由器/台灯供电。订单结束后，调用{"power3":"0"}断电 。
智能家居/办公集成
如果你正在使用 HomeAssistant（HA） 或其他开源物联网平台，你可以通过“自定义RESTful Sensor/Switch”组件，将上述的HTTP请求封装起来，从而将这款工业级8路控制器无缝接入苹果HomeKit或谷歌Home生态。
四、 注意事项与排错
负载限制：单路最大支持 2200W（阻性负载，如白炽灯） ，但如果是 感性负载（如电机、LED灯） ，功率需降额使用（不超过350W），否则可能损坏触点 。
关于返回值：API返回
code：200仅代表指令到达云端，不代表设备执行。如果设备离线，命令会下发失败。利用芯步提供的 消息推送 功能，获取设备执行后的真实反馈（ACK）。局域网通信：该设备支持私有化部署，如果你的创客项目是在局域网内使用（不需要外网），可以将API请求指向设备的局域网IP，实现更低延迟的本地控制。