16A智能插座常用于空调、热水器等大功率设备的用电管控。芯步的开放接口采用HTTP协议，签名验证简单，可在公网或纯局域网环境下使用。以下方案涵盖硬件选型、接口对接方法和三种定时管控的实现方式。

1. 解决概述

本方案基于芯步开放的 HTTP API 接口，通过向其云平台发送标准 HTTP 请求，实现对 16A 智能插座 的远程通断控制及定时任务设定。

适用场景

• 空调、热水器、工业设备的定时开关机。

• 园区/办公区域的用电节能管理（下班自动断电）。

• 充电桩/大功率设备的远程计费与控制。

技术优势

• 无网关依赖：设备直连 WiFi 2.4GHz。

• 响应迅速：命令下发到执行仅需 80-120ms。

• 接口友好：仅需 HTTP POST 请求，支持任何编程语言（Java, Python, Node.js, PHP 等）及纯局域网环境。

2. 硬件选型与环境准备

2.1 硬件选型

针对 16A 大电流场景，推荐选用以下设备：

• 智能墙壁插座16A（计量版）：型号 UNI-QC-16A-P。适用于空调、16A 大功率插座直连，支持电压、电流、功率实时计量。

• 智能插座16A（计量版）：型号 UNI-CZ-16A-P。桌面级或排插形式，即插即用，支持 WiFi 直连。

2.2 开发准备

在开始开发前，需准备以下三个参数（在芯步开发者控制台获取）

3. 核心接口对接：签名与请求

芯步的接口采用双重 MD5 签名机制。假设您的系统需要定时关闭空调，需向 /device/control/ 接口下发指令。

3.1 签名计算规则

为了接口安全，每次请求必须携带 sign 和 ts（时间戳）参数。计算逻辑如下

1. 将 AppSecret 进行一次 MD5 加密，得到 Sign_A。

2. 将 Sign_A 拼接上当前秒级时间戳 ts，得到字符串 Sign_A + ts。

3. 将上述拼接后的字符串再次进行 MD5 加密，得到最终 sign。

用公式表达为：sign = MD5( MD5(AppSecret) + ts )

3.2 接口请求详解

• 请求地址： http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求方式： POST

• Header： Content-Type: application/json

• Body 数据格式

  { "device": "设备ID", "order": { "power": 1 } // 命令对象 }

4. 定时管控的三种实现方案

根据业务复杂度和精度要求，推荐以下三种定时管控策略：

方案一：设备端硬件定时（高精度、高可靠）

利用插座本身的“先通后断”或“脉冲”功能。适用于 “开启X小时后自动关闭” 的场景（如热水器定时加热）。

• 场景：办公楼饮水机，下班后通电加热 2 小时自动断电。

• 下发命令：接通电源，并在 7200000 毫秒（2 小时）后自动断电。

  { "device": "820720", "order": { "reset": 7200000 } }

注：reset 命令意为“先接通，等待指定毫秒后断开”。

方案二：云端定时任务（简单循环）

利用芯步云平台内置的 定时任务引擎。适用于 “每天固定时间点” 循环操作（如早上 8:00 开空调，下午 18:00 关空调）。

• 实现的方式是：登录芯步控制台或调用定时任务接口，设置 Cron 表达式或固定时间点的“触发器”。

• 操作：无需维护服务器上的定时队列，由云端负责在指定时间向设备发送 {"power":1} 或 {"power":0} 命令。

方案三：业务层自主调度（最灵活）

由您的业务服务器管理定时逻辑（如 Quartz 任务），在时间到达时，由您的服务器主动调用上述 HTTP 接口控制插座。适用于 “非周期性、动态调整” 的场景。

5. 实战代码示例

以下代码演示如何通过签名算法，调用接口控制 16A 插座通断。

Python 3 实现

Java (OkHttp) 实现

6. 设备状态实时监听（可选）

为了实现更精细的管理，可以监听设备的 上行消息。芯步支持将设备消息推送到您自己的服务器。

1. 设置消息接收 URL：在开发者控制台配置您的服务器回调地址。

2. 数据流向：当 16A 插座电量变化、功率超限或有人按下物理按键时，芯步云会向您的 URL 推送 JSON 数据。

3. 应用：通过接收“功率”数据，可以判断空调是否真的启动了（电流反馈），实现闭环控制。

7. 总结

通过芯步的 16A 智能插座及其开放 API，企业可以快速实现大功率设备的用电定时管控。开发流程总结为：

1. 采购：选择 16A [计量版] 硬件并通电配网。

2. 注册：获取 AppId、Secret 和设备 ID。

3. 集成：在后端实现 MD5 签名算法，调用 /control/ 接口。

4. 逻辑：根据业务需求，组合使用“硬件 reset 定时器”、“云端 Cron 定时任务”或“业务层调度”。