智能办公交流电路控制：怎么将AC4-30A 物联网开关对接到软件项目中_解决方案

CATALOG

芯步的AC4-30A智能通断器提供了标准HTTP接口，签名机制清晰，对接门槛较低。以下方案涵盖设备选型、接口鉴权、代码实现及办公场景。

1. 解决概述

在现代智能办公系统中，对电源的精细化管理是节能和自动化的重要一环。AC4-30A 智能通断器作为执行终端，负责控制220V交流电路的通断。开发者通过调用芯步开放的 HTTP API 接口，可以轻松地将硬件控制能力集成到现有的 Web 应用、移动端小程序、企业微信/钉钉应用或SaaS后台 中。

本方案的核心目标是：无需复杂的嵌入式开发，仅通过标准HTTP请求，实现软件系统对强电线路的远程双向控制。

2. 硬件与参数

项目	规格说明
产品型号	UNI-TDQ-AC4-30A
工作电压	AC 85-265V (宽电压，适配全球市电)
额定电流	MAX 30A
负载功率	阻性负载：6600W (如照明、取暖)；感性负载：1100W (如电机、风扇)
通信方式	Wi-Fi 2.4GHz (直连路由器，无需网关)
控制方式	HTTP API (支持公网/局域网)、物理按键、定时任务
接口协议	HTTP POST (JSON格式)

该设备适用于控制工位插座、照明回路、饮水机、会议室投影幕布电源等各类办公电器。

3. 接口对接流程

芯步的接口设计遵循无状态、轻量化的原则，签名机制保证了API调用的安全性。

3.1 准备凭证

在芯步物联网控制台中，获取以下关键信息：

AppId：应用的唯一标识。
AppSecret：用于签名计算的密钥。
Device ID：设备的唯一ID（可在控制台查看或通过设备列表接口拉取）。

3.2 签名计算规则

为了保证接口安全，每次请求需携带签名（sign）和时间戳（ts）。计算规则为双重MD5加密：

Sign = MD5( MD5(AppSecret) + ts )

即：将 AppSecret 进行一次MD5加密（生成小写32位），拼接上当前的Unix时间戳（秒级），再将这个新字符串进行一次MD5加密。

3.3 API 请求地址

[Method] POST
[URL] http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
[Header] Content-Type: application/json
[Body] {
    "device": "设备ID",
    "order": {"power": 1}  // 命令对象
}

4. 代码集成实现

无论您的软件项目后端是 Java、Python、PHP 还是 Node.js，只要支持 HTTP 库，都可以轻松集成。以下展示三个常用场景的集成示例：

第一种场景：Python 后端集成 (适用于Django/Flask)

import hashlib
import time
import requests
import json

class YoyoIoTController:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret

def _generate_sign(self, ts):
        # 1. MD5加密 Secret
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 拼接时间戳
        combined = md5_secret + str(ts)
        # 3. 再次 MD5 得到签名
        sign = hashlib.md5(combined.encode()).hexdigest()
        return sign

def control_device(self, device_id, power_status):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"https://api.thingboot.com/{self.app_id}/device/control/"
        params = {
            "sign": sign,
            "ts": ts
        }
        payload = {
            "device": device_id,
            "order": {"power": 1 if power_status else 0}
        }
        
        response = requests.post(url, params=params, json=payload)
        return response.json()

# 业务调用示例
controller = YoyoIoTController("Your_AppId", "Your_AppSecret")
# 打开会议室电源 (假设设备ID为 820720)
result = controller.control_device("820720", True)
print(result)

第二种场景：前端/小程序直接调用 (JavaScript)

在管理后台或小程序中，通常需要通过后端代理转发，以避免 AppSecret 泄露。但如果是在云函数（Serverless）或内部网络中，可直接计算签名调用。

第三种场景：Shell 脚本调用 (适用于自动化运维)

适用于 Linux 服务器通过定时任务（Crontab）控制设备开关。

5. 进阶：智能办公场景

将接口集成到软件项目后，可以构建以下“交流电路控制”逻辑，实现真正的智能办公：

5.1 会议管理系统联动

逻辑：当员工在前端界面预订会议室时，系统自动在该会议开始前5分钟发送指令 {"power":1} 开启投影仪电源和空调；会议结束后，发送 {"power":0} 切断电源。
涉及设备：AC4-30A（串联在投影仪/空调插座前）。

5.2 工位与能耗管理

逻辑：通过软件后台设定下班时间（例如 19:00），系统自动扫描所有关联的工位插座通断器，执行断电指令。同时支持“加班申请”流程：员工提交加班申请通过后，系统临时为指定设备上电，并设定 {"reset": "7200000"}（2小时后自动断电报文），以防忘记关灯。
命令示例{"reset": 7200000} —— 设备会立即接通，2小时（7200秒）后自动断开。

5.3 私有化与局域网部署

对于金融、研发等注重数据安全的办公环境，该系列产品支持 私有化部署。软件项目可以不经过公网，直接连接局域网内的设备接口，数据完全隔离，保障了办公网络的物理安全。

6. 总结和需要注意的点

负载安全：虽然设备支持 30A 电流，但在办公场景接入大型机房服务器时，请确认功率不超过 6600W。对于感性负载（如电梯、大型空调压缩机），降额至 1100W 使用。
网络依赖：设备依赖 2.4G Wi-Fi，部署时请确保安装位置信号强度足够。设备支持存储 5 组 Wi-Fi 密码，增强了漫游能力。
响应速度：从接口调用到设备机械动作，延迟约为 80-120ms，完全满足办公场景下的即点即控需求。

通过以上方案，开发者可在 1小时内 完成从注册、配网到第一个接口调用的全过程，快速打通软件逻辑与物理电路控制。