基于芯步的开放接口体系，24路智能分体远程控制设备（型号UNI-KZQ-FT/UNI-KZQ-TY-24）提供了完整的HTTP API接口，支持单路控制、批量控制、延时通断等多种指令模式。以下从技术架构、接口规范、核心场景集成三个维度展开说明。

1. 解决方案架构概述

要实现对 24 路设备（UNI-KZQ-FT）的远程集中控制，推荐采用 “中心服务器/云平台 + 设备直连” 的星型网络模型。芯步的接口设计屏蔽了底层复杂的网络穿透问题，开发者只需关注业务逻辑。

• 控制端：PC、手机App、Web后台或本地服务器。

• 传输层：HTTP/HTTPS 公网API 或 MQTT 协议。

• 设备端：24路智能分体控制器（支持WiFi 2.4GHz/有线网络）。

• 联动机制：通过轮询或消息推送，依据业务规则（如时间表、传感器阈值）触发指令。

2. 核心接口对接详解：实现“集中控制”

对接的关键核心是 /device/control/ 接口。该接口支持单设备控制和批量设备控制（最多100台），这为集中管理大量24路控制器提供了基础。

2.1 鉴权机制

为了系统安全，每次调用都需要携带签名。公式为：

sign = md5( md5(AppSecret) + ts )

AppSecret 由芯步控制台生成，ts 为Unix时间戳。

2.2 单路独立控制（场景：精细化管理）

该设备最核心的功能是 24路分控，意味着每一条线路（power1 到 power24）都可以独立下发开关指令，互不干扰。

• 接口地址https://api.thingboot.com/{AppID}/device/control/

• 请求方式：POST (JSON格式)

• 请求示例 (控制第8路开启)

  { "device": "设备唯一ID（可在外壳或控制台查看）", "order": { "power8": 1 // 1为开，0为关 } }

  注：命令中的 extra 字段可用于携带订单号等业务上下文，设备执行结果回调时会原样返回，便于异步对账。

2.3 批量控制与场景联动（场景：一键执行）

在需要对多个回路同时操作时（例如闭店时一键关闭所有灯光、空调、排气扇），逐条发送24条指令效率较低且存在延迟。利用接口的 batch 命令可以一次性操作多个回路。

• 请求示例 (关闭第1、3、5、10路) ：

  { "device": "设备ID", "order": { "batch": { "relay": [1, 3, 5, 10], "power": 0 // 0=关闭，1=开启 } } }

  参考自类似产品的批量接口设计。

2.4 延时与顺序控制（场景：保护设备）

在某些场景下，需要“先断后通”或“先通后断”。例如控制电机或排风扇时，直接切换可能会导致电流冲击或机械故障。该设备接口支持 point（点动/先通后断）和 reset（先断后通）指令，可精确到毫秒级。

• 点动示例(第2路通电2秒后自动断开) ：

  { "order": { "point": { "relay": [2], "interval": 2000 // 单位毫秒 } } }

  技术说明：该指令会先接通继电器，维持2000ms后自动断开，适用于门禁电磁锁或短暂触发类设备。

3. 高级集成方案：构建传感器联动模块

题目中提到的“联动模块”，在物联网架构中通常指逻辑触发器（Rule Engine）。结合芯步的传感器产品线，可以实现真正的自动化，而不仅仅是手动点击控制。

3.1 联动实现逻辑

1. 上行数据接收：环境传感器（如UNI-SENS-雷达存在传感器）探测到“有人/无人”状态。

2. 业务处理：您的服务器在接收到传感器上报的数据后，运行业务逻辑。

3. 指令下发：服务器判定“无人”超过10分钟，随即调用上述 /device/control/ 接口，向24路控制器发送“全关（batch power=0）”指令，实现节能。

3.2 异步消息推送保障可靠性

需要注意的是，HTTP API返回的 200 状态码只代表平台收到了指令，并不代表设备真的执行了动作（设备可能断电或离线）。对于关键业务场景（例如开启贵重设备），配置 设备状态消息推送

• 您的服务器需提供一个公网回调URL。

• 当设备实际执行指令成功或失败后，平台会主动推送执行结果到此URL。

• 您的系统即可根据此回调更新数据库中的“设备状态”，确保界面显示与实际物理状态一致。

4. 私有化部署与内网穿透替代方案

对于对公网依赖较低或对数据安全要求较高的场景，芯步支持 “软网关” 模式。

• 适用场景：校园局域网、企业内部局域网、保密单位。

• 实施步骤

  1. 在内网服务器上安装“芯步软网关”。

  2. 24路设备配置为“网关模式”，指向该内网服务器IP。

  3. 您的内部系统直接调用内网服务器的 HTTP 接口（例如 http://192.168.1.100/control）。

• 优势：完全不经过公网，响应时间可低至10ms以内，且无需复杂的签名算法，适合高频次、低延迟的工业自动化场景。

5. 典型应用场景代码串联（伪代码逻辑）

以下以一个自习室或办公室的“一键上班/一键下班”场景为例，展示如何用代码逻辑整合上述接口：

总结

对接芯步24路智能分体控制器，本质上是通过标准化的HTTP调用将物理继电器操作抽象为API接口。开发者只需关注以下几点：

1. 指令格式：区分单路（powerX）、批量（batch）、延时（point/reset）。

2. 提升并发：利用 device 参数支持多ID的特性（用|分隔），在平台层面批量下发指令，减少网络往返延迟。

3. 保障一致性：利用异步消息推送校验设备真实状态。