AC1的开放接口基于标准HTTP协议，签名机制清晰、命令格式统一，便于集成到各类系统中。以下是完整的接入方案：
1. 产品概述与核心参数
适用设备：芯步智能通断器AC1（2200W／10A版）
在进行接入开发前，首先需要明确AC1的硬件规格和适用场景。AC1是一款支持WiFi远程控制的单路智能通断器，核心参数如下
工作电压：AC 85-265V（宽电压，适配全球市电）
额定电流：MAX 10A
负载功率：阻性负载最大2200W（如白炽灯、电热器）；感性负载最大700W（如电机、压缩机）
控制方式：支持物理按键（点动／自锁模式）和HTTP远程控制（API）
特色功能：支持断电记忆、上电状态设置、自定义联动逻辑
该设备适用于智能家居（灯光、窗帘、插座）、共享设备（洗衣机、充电桩、自习室电源）、工业控制（水泵、风机启停）等场景。
2. 接入设计
要实现“自定义联动逻辑控制”，核心思路是：传感器采集数据 -> 您的服务器逻辑判断 -> API下发指令至AC1 -> AC1执行通断。
如下图所示，整个架构由四层构成：
| 层级 | 组成 | 说明 |
|---|---|---|
| 感知层 | 传感器（温湿度、红外、门磁等）或您已有的软件业务系统 | 触发联动的条件来源，如温度超限、红外感应、订单支付成功 |
| 传输层 | 路由器2.4G WiFi，广域网或局域网通信 | 保证设备与云端的连接稳定性 |
| 平台层 | 芯步开放API，您的业务服务器 | 核心逻辑层：接收事件、判断规则、生成指令、调用API |
| 执行层 | 2200W智能通断器AC1 | 接收信号后接通／断开电路，控制被接入电器的电源 |
3. 准备工作：设备配网与凭证获取
在编写代码前，需要完成设备激活和密钥配置。以下是详细步骤：
3.1 注册与创建应用
访问芯步官网，注册企业／开发者账号。登录后进入控制台，创建“工作台”并安装“物联网控制台”模块。在控制台创建您的应用，系统将生成一组密钥：
AppID：应用的唯一标识
AppSecret：用于计算接口签名，需妥善保管
3.2 设备配网
AC1仅支持2.4G WiFi频段，推荐使用小程序配网：
微信搜索并进入“芯步”小程序，登录您的账号。
确保手机已连接2.4G WiFi，在小程序中点击“添加设备”->“配置网络”。
输入WiFi密码，点击“为设备配置此网络”，此时将手机热点改为指定格式（步骤中有提示）。
给AC1通电，长按配网键直至指示灯快速闪烁，等待设备自动连接。
配网成功后，在“物联网控制台”的设备列表中可以看到该设备，并获取到唯一的Device ID。
3.3 配置数据接收服务
为了实现传感器联动AC1，您需要在控制台配置“消息推送”URL。当传感器上报数据时，芯步平台会将数据POST到您的服务器地址。
4. 接口协议详解
芯步开放API采用标准的HTTP协议，请求地址为：https://api.thingboot.com/{AppId}/device/control/？sign={sign}&ts={ts}
4.1 签名算法
请求需携带签名（Sign）和时间戳（Ts）以验证身份。计算步骤如下
secret_md5 = md5（AppSecret）（小写32位）sign_str = secret_md5 + ts（直接拼接字符串）sign = md5（sign_str）
示例：
4.2 控制指令格式
请求方式为POST，Content-Type为application/json。Body参数结构
AC1指令集
| 功能描述 | Order JSON格式 | 说明 |
|---|---|---|
| 开启 | {“power”：1} | 接通电路，上电 |
| 关闭 | {“power”：0} | 断开电路，断电 |
| 状态保持/点动 | {“power”：{“keep”：“0”，“revert”：“3”}} | 保持关，手动开3秒后自动关 |
| 先通后断（脉冲） | {“point1”：“2000”} | 通电，2秒后自动断电 |
| 先断后通（重启） | {“reset1”：“2000”} | 断电，2秒后自动通电 |
响应示例：
5. 实现自定义联动逻辑
假设场景：当温度传感器检测到室温超过30°C时，自动开启AC1连接的排风扇；当温度低于25°C时，关闭排风扇。
5.1 接收传感器数据
您的服务器接收传感器上报的数据（配置在控制台的“消息推送”URL）：
POST http://your-server.com/api/sensor/callback
{
"device": "sensor_001"，
"data": { "temperature": 32.5 }
}5.2 业务逻辑判断
在服务器中编写规则引擎：
5.3 下发控制指令
封装API调用函数：
6. 高级逻辑与优化
6.1 批量控制
如果需要同时控制多个AC1设备，可以在device字段中用逗号分隔多个ID：
6.2 局域网直连控制
对于对延时要求较高的场景，AC1支持局域网控制。您可以通过轮询获取设备的局域网IP，在相同网段内直接发送POST请求，无需经过公网，响应时间可缩短至20ms以内。需在控制台开启“局域网控制”功能。
6.3 互斥逻辑
如果有多个设备接入，需要防止短路等情况，可以设计互斥逻辑。例如控制AC1_1（总闸）接通前，先调用接口断开AC1_2（支路），确保安全。
6.4 状态同步
为确保服务器状态与设备真实状态一致，定期调用查询接口接口拉取设备最新状态，并处理平台推送的设备状态变更消息。
7. 注意事项
功率限制：AC1最大支持2200W，接入感性负载（如电机、空调压缩机）时，降额至700W使用，否则可能烧毁触点。
WiFi稳定性：设备仅支持2.4G WiFi，确保信号强度。在工业环境下进行现场信号勘测。
签名时效：时间戳参数
ts通常有效期为5-10分钟，过期需重新生成。错误处理：接口调用失败时，应根据返回的HTTP状态码和业务code进行重试（如遇网络抖动），采用随机间隔（或逐次增大间隔）策略。
安全审计：勿将AppSecret硬编码在前端代码中，所有API调用须经由您的后端代理。
通过以上方案，您可以高效地将芯步AC1集成到您的软件系统中，实现高度自定义的自动化联动控制。