AC4-20A 智能通断器的核心优势在于：它走 WiFi 直连，无需额外网关，控制接口就是标准 HTTP API，这意味着任何能发请求的编程语言都能轻松驱动它。以下方案从硬件接线、云平台注册、接口调用到代码示例，帮你完整走通接入流程。
智能办公交流电路控制解决方案：AC4-20A 物联网开关接入指南
1. 解决概述
在智能办公环境中，交流电路控制通常用于照明、工位插座、饮水机、新风系统等设备的远程通断管理。芯步智能通断器 AC4-20A 是一款支持大电流（4-20A，峰值 4400W）的继电器控制设备。
本方案的目标是指导开发者如何利用该设备的 HTTP API 接口，将其快速集成到现有的办公自动化（OA）系统、能源管理系统或楼宇自控平台中。通过该方案，可以实现工位用电器的远程巡检、定时关断（节能减排）以及故障复位功能。
2. 硬件参数与选型确认
在开始集成前，请确认硬件规格符合您的项目负载：
电流范围：AC 4-20A（支持 220V 市电，最大 4400W，适用于大多数办公插座回路）。
控制方式：继电器输出（干触点/湿触点根据型号），支持断电记忆功能。
通信方式：Wi-Fi（2.4G 频段，不支持 5G）。
接口协议HTTP Client/Server（无需网关，直连云平台）。
3. 集成设计
本方案采用标准的物联网三层架构，无需购买额外网关：
设备端：AC4-20A 设备部署在强电箱内，串入办公区域的回路火线。
应用端：设备连接现场 2.4G Wi-Fi 后，自动连接芯步公有云（或私有化部署服务器）。
应用侧：您的办公管理后端通过 HTTP 请求调用云平台 OpenAPI，下发开关指令并接收设备状态。
4. 详细接入步骤
4.1 硬件安装与配网（上线准备）
在编写代码前，需要确保设备处于在线状态。
接线：必须由专业电工操作。确认总闸断开后，将设备串联至负载（如照明灯）的火线回路中（L/N 输入输出不可接反）。
配网
手机下载“芯步”小程序并注册账号。
开启手机 2.4G 热点（名称密码需与现场 Wi-Fi 一致）。
长按设备配网按钮，等待指示灯进入快闪状态。
在小程序中点击“添加现场 WiFi”并保存，设备将自动抓取网络配置。
4.2 获取核心凭证（Token & ID）
您需要从云平台获取以下三个关键信息，用于后续 API 鉴权：
AppID：您的应用唯一标识。
Device ID：智能通断器的唯一 ID（通常贴在设备外壳或显示在控制台设备列表中）。
Sign 算法：平台提供的签名生成规则（通常涉及 AppSecret 与时间戳 Ts 的 MD5 加密）。
4.3 API 接口调用实现（核心开发）
这是集成工作的核心。设备支持 HTTP 和 MQTT 两种方式，这里以最通用的 HTTP POST 请求为例。
接口详情：
URL：
http(s)://api.thingboot.com/{AppID}/device/control/Method： POST
鉴权参数：需要在 URL 中携带
sign和ts。ts：Unix 时间戳（秒），用于防止重放攻击。sign：签名，用于验证身份。
1. 控制设备闭合（开/关）假设我们需要控制设备打开（Power On）：请求示例（JSON Body）：
*注意：对于 AC4-20A 这款单路设备，主要控制指令就是 power 字段，值为字符串格式的 1 或 0*。
2. 关于 Sign 的生成逻辑请求 URL 中必须包含动态签名。虽然官方文档未在此处粘连具体代码，但通常逻辑如下（伪代码示意）：
sign = MD5( AppID + AppSecret + ts )
完整请求 URL 示例：https://api.thingboot.com/APP_123456/device/control/?sign=abc123def456&ts=1700000000
4.4 高级功能开发（定时与联动）
利用接口还可以实现更复杂的办公策略：
远程定时任务：您不需要在本地维护定时器。可以通过调用平台的“定时任务创建接口”，直接在云端为设备设置定时策略（例如：每天晚上 22:00 自动断电）。这样即使您的办公服务器关机，策略依然在云端执行。
状态查询：通过调用设备状态查询接口，可以获取当前设备的实时通断状态，用于在 OA 大屏上显示。
5. 项目落地代码示例（Python / Node.js）
以下以 Python 为例，展示如何编写一个简单的办公照明控制脚本：
6. 办公场景特定配置与排障
1. 按钮自定义与屏蔽在办公区（如会议室、茶水间），为了防止现场人员误触物理开关导致节能策略失效，可以通过接口设置 “按钮动作可屏蔽” 或自定义按钮行为。你可以将这些配置写入初始化脚本中，将物理按键锁定，仅接受系统平台控制。
2. 局域网控制（低延迟方案）如果您的办公室内网非常稳定，且对控制延迟要求比较高（如灯随人动场景），AC4-20A 支持 局域网发现与直连。
您的后端程序可以不再经过云平台，直接在局域网内通过 HTTP 请求设备本地 IP 地址进行控制，这种方式的响应通常在 10ms 级别。
3. 常见异常排查
设备离线：检查现场 WiFi 是否稳定，AC4-20A 仅支持 2.4G 频段，双频路由器请确保 2.4G 信号开启。
下发失败（Code 502）：检查 Device ID 是否输入正确，以及设备在控制台是否仍属于您的账号下。
负载不动作：4400W 额定功率虽然大，但办公区常用的 LED 驱动电源启动瞬间电流较大，预留余量。如果控制日光灯等感性负载，请确认设备支持类型（多数交流继电器适用）。
通过以上方案，您可以将 AC4-20A 物联网开关无缝对接到 OA 系统、企业微信小程序或自研能源看板中，实现办公用电器的精细化管理。