1 产品概述与技术特性
芯步AC1-10A智能通断器（型号：UNI-TDQ-AC1-10A）是一款专为智能家居照明及电器控制设计的WiFi远程控制设备。该设备采用WiFi 2.4GHz无线网络直连方式，无需额外网关即可独立工作，大幅降低了系统部署的复杂度和成本。设备支持2200W额定功率（16A大功率设计），可满足从普通照明到家用电器等多种负载类型的控制需求。
该产品的核心优势在于其开放的HTTP接口体系，支持任何能够发起HTTP请求的编程语言和开发框架，可无缝集成至Web应用、移动APP/小程序、桌面软件以及SaaS/低代码平台等多种项目形态中。这意味着开发者无需受限于特定厂商的SDK或私有协议，能够以标准化的方式快速实现设备控制功能的集成。
对于对数据安全或网络环境有特殊要求的项目，AC1-10A还支持私有化部署方案，允许开发者自建消息服务器，使设备运行在纯局域网环境中，完全规避云端依赖。
2 接入准备与开发环境配置
在开始编码工作前，需要完成以下准备工作以确保后续接口调用的顺利进行。
第一步：平台注册与设备配网首先访问芯步官网完成账号注册，登录后进入物联网控制台。将AC1-10A设备接通电源，通过平台提供的批量配网小程序或控制台引导页面，将设备连接至本地2.4GHz WiFi网络。设备支持设定5组WiFi网络，可优先连接信号最强的网络，确保网络连接的稳定性。
第二步：获取开发凭证在控制台左侧导航栏进入“开发设置”页面，完成两项关键配置
开发者ID（AppId）：平台为您的应用分配的唯一标识符，将用于接口URL的路径参数
开发者密码（AppSecret）：用于生成接口签名鉴权的密钥，请妥善保管
在开发测试阶段，可以开启“调试模式”暂时跳过签名校验，便于快速验证接口功能；但在生产环境中请一定要关闭此模式并按规范实现签名算法。
第三步：获取设备标识在控制台的设备管理页面，找到已配网的AC1-10A设备，记录其唯一的设备ID（如案例中的1878），该ID将作为接口调用中标识目标设备的关键参数。
3 接口鉴权与签名算法
芯步开放接口采用动态签名的方式进行身份验证，每个请求都需要携带计算正确的签名（sign）和时间戳（ts）。这种机制既防止了接口被恶意重放攻击，也验证了调用者的合法身份。
3.1 签名生成规则
签名的生成算法分为两个步骤，具体流程如下
对开发者密码（AppSecret）进行第一次MD5加密，得到中间值
secret_md5 = MD5(AppSecret)将第一步的结果与当前Unix时间戳（秒级）进行拼接，格式为
{secret_md5}.{ts}对拼接后的字符串进行第二次MD5加密，得到最终签名
sign = MD5({secret_md5}.{ts})
3.2 不同编程语言的签名实现示例
JavaScript (Node.js) 实现：
Python 实现：
Java 实现：
4 设备控制接口调用详解
AC1-10A智能通断器的核心功能是控制一路线路的通断状态，所有控制操作均通过HTTP POST请求完成。
4.1 接口基本信息
| 项目 | 说明 |
|---|---|
| 请求地址 | http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts} |
| 请求方式 | POST |
| 数据格式 | Content-Type: application/json |
| 响应时间 | 80-120ms |
4.2 请求参数结构
请求体为JSON格式，包含两个顶层字段
参数说明：
device：字符串类型，目标设备的唯一标识，可在控制台查看
order：JSON对象，包含具体控制指令。对于AC1-10A设备，核心命令为
power，取值为1（接通/开）或0（断开/关）
4.3 基础控制示例
以下示例演示如何通过curl命令控制AC1-10A设备打开照明：
5 高级控制功能
AC1-10A不仅支持基本的开关控制，还提供了多种智能化控制模式，能够满足更复杂的业务场景需求。
5.1 定时通断控制（先通后断）
使用point命令可以实现线路在指定时间后自动断开，适用于楼道照明、设备临时供电等需要自动关闭的场景。命令格式为：{"point":持续时间(毫秒)}。
示例：线路接通30秒后自动断开
5.2 定时恢复控制（先断后通）
使用reset命令可以实现线路在断开指定时间后自动重新接通，可用于某些需要周期性重启的设备维护场景。命令格式为：{"reset":持续时间(毫秒)}。
示例：线路断开5秒后自动重新接通
5.3 多设备批量控制
同一接口支持同时对多个设备下发命令，只需在device字段中用英文逗号分隔多个设备ID。这种方式虽然通过单次HTTP请求完成，但每个设备会独立执行命令，适用于需要同时控制多个照明回路的场景。
6 状态同步与消息推送机制
为实现系统状态的一致性和实时响应，AC1-10A提供了类似微信公众号的消息推送机制。当设备状态发生变化时（包括用户手动操作、定时任务触发或远程控制），平台会主动将状态变更消息的推送至开发者预先配置的URL地址。
6.1 回调接口配置
开发者在控制台的“开发设置”中配置消息接收URL，该URL需指向您的服务器端接口。平台会在设备状态变化时向此地址发送HTTP POST请求，请求体包含设备ID、变更后的状态、变更时间等信息。
6.2 回调接口实现示例（Node.js/Express）
6.3 状态同步最佳实践
在实际项目中，采用“主动查询+被动接收”相结合的双重机制
消息推送用于实现业务系统的实时响应，例如控制台UI的即时刷新、异常告警等
接口查询作为兜底校验手段，在页面加载或关键操作前获取最新设备状态
7 多平台集成实践方案
基于AC1-10A开放的HTTP接口体系，该设备可以灵活接入多种类型的项目平台。
Web管理后台集成：在Vue/React等前端框架中封装设备控制服务模块，通过Axios等HTTP客户端调用接口。控制台类项目通常需要创建设备管理界面、操作日志记录和权限控制体系。
移动端APP/小程序集成：在微信小程序中使用wx.request发起控制请求。移动端场景需特别注意网络异常处理、加载状态反馈和操作确认机制。实现离线队列功能，在网络恢复后自动同步未完成的控制指令。
自有SaaS平台集成：将设备控制能力作为标准API服务输出。封装统一的设备服务层，可实现多租户隔离、设备分组管理、定时任务调度和企业级权限控制。私有化部署版本可完全运行在您的自有服务器环境中。
8 最佳实践和需要注意的点
在实际项目开发中，需充分考虑设备控制系统的稳定性和可靠性。
错误处理机制：网络请求必须配置合理的超时时间（3-5秒）和重试策略（最多3次），同时妥善处理设备离线等异常状态。
签名安全保护：AppSecret相当于设备控制权限的钥匙，严禁硬编码在客户端代码中。生产环境应将所有设备控制请求收口至自有后端服务，由后端完成签名计算和设备指令下发。
设备离线处理：AC1-10A依赖WiFi网络，在业务层面实现“最后一次在线”状态记录，并在指令下发失败时提供友好的用户提示。
通过以上方案，您可以将芯步AC1-10A智能控制器快速、稳定地集成到各类智能家居照明控制项目中，实现灵活的远程控制与智能化管理。