智能断路器35A是芯步WiFi直连设备，开放HTTP接口，支持远程及定时控制。以下方案涵盖配网、接口对接、定时任务实现和异常处理，可帮助快速集成到现有系统中。
1. 产品概述与对接基础
1.1 设备简介
芯步35A智能电源保护开关（型号：UNI-DLQ-35A）是一款支持大电流（35A）承载的工业/家用智能断路器。其核心特性在于无需额外网关，直接通过WiFi 2.4G网络连接路由器，并开放底层的HTTP API接口，允许用户完全脱离官方App，将设备集成到自有系统中。
1.2 适用场景
本方案适用于需要对大功率设备（如中央空调、热水器、工厂机器、充电桩）进行远程定时启停或能耗监控的场景。
1.3 关键对接前提
在开始技术对接前，需确保以下条件满足：
网络环境：设备安装位置有覆盖良好的2.4G WiFi信号（不支持5G频段）。
接口权限：获取芯步提供的API Key / Access Token（如需要）以及设备ID（Device ID）。
开发能力：具备发送HTTP请求的能力（支持任何语言：Python, Java, PHP, Go, Node.js等）。
2. 对接设计
为了实现“远程定时通断控制”，采用 Server-Device 直连架构
设备层：35A智能断路器，负责执行通断指令。
网络层：WiFi路由器（设备与服务器保持长连接/心跳）。
业务层：用户的业务服务器或云平台（SaaS）。
控制端：Web端管理后台、手机APP（自研）或小程序。
交互流程（定时任务为例）
用户在业务端设置定时规则（如：每天18:00关，22:00开）。
业务服务器将规则存入数据库，并启动本地定时器。
触发时刻：业务服务器向芯步开放平台（或设备局域网IP）发送
HTTP POST指令。云平台/路由器转发指令给35A智能开关，开关执行动作并返回结果。
3. 详细对接步骤
3.1 设备配网与激活
虽然重点在API，但需要对设备进行初始配置，使其连入网络并获得IP。
配网方式
AP模式（推荐用于批量） ：设备自身发射热点，手机/电脑连接后配置路由信息。
智能配网（SmartConfig）：通过广播包配置。
获取设备ID：配网成功后，通过芯步提供的查询接口或在后台管理系统中获取唯一的设备标识符（
device_id），这是后续所有控制动作的唯一凭证。
3.2 接口鉴权与基础信息
根据芯步的产品手册，接口设计简单，基于HTTP请求。通常情况下，你需要引入以下Header参数（获取最新文档需向厂商确认具体Key值）：
Content-Type: application/json
Authorization: Bearer {YOUR_ACCESS_TOKEN}3.3 核心功能开发：通断控制
这是对接“远程控制”的核心，即发送开关指令。
请求URL
https://api.yoyoiot.com/ordercontrol（假设路径，请以实际API文档为准）或者如果处于同一局域网，利用局域网API直连（延迟更低）：http://{device_local_ip}/api/cmd请求方法：POST
请求体示例
代码示例（Python脚本触发闭合） ：
3.4 状态查询与反馈
为了确保定时任务的可靠性，通常在发送开关指令后，查询一次设备状态进行确认，或者通过Webhook接收设备主动上报的状态。
查询接口
GET https://api.yoyoiot.com/orderstatus?device_id=xxx返回示例
3.5 实现“定时任务”逻辑
由于云端定时存在延迟或网络抖动风险，生产环境中通常有两种实现方案，这里重点推荐方案一
方案一：业务服务器侧定时调度（高精度、低成本）这是最灵活的方式，利用业务系统的代码逻辑实现。
数据库设计：设计一张定时任务表，包含
device_id，cron_expression（或执行时间），action（ON/OFF），is_enabled。调度器实现：使用Linux Crontab、Windows Task Scheduler，或者代码层面的APScheduler（Python）或 Quartz（Java）。
执行逻辑
每扫描到一条待执行的指令。
调用步骤3.3中的
control_35a_switch函数。超时处理：若指令发送失败（网络抖动），设置重试机制（如每5秒重试一次，共3次）。
日志记录：记录下每次通断操作的时间、发起方（定时任务）、结果。
方案二：利用设备自带RTC时钟（离线执行）查阅设备手册发现其支持“5组WiFi网络”，通常也支持设置固件内部的定时器。通过网络调用设置设备内部时钟：
指令
cmd: "set_timer"参数
start_time: 1688169600,end_time: 1688173200,repeat: "1-5"优势：即使断网，设备自己也会执行通断；业务服务器压力小。
劣势：配置相对复杂，管理大规模批量设备时，修改定时规则成本较高。
4. 异常处理与可靠性
由于是应用于35A大电流场景（如工业设备、充电桩），安全稳定性是首要考量。
指令确认机制
在发送“断开”指令后，再次调用状态查询接口，确认电流归零。如果电路依然闭合且电流过大，应触发业务告警。
断网重连逻辑
设备支持多组WiFi配置。在配置过程中，至少设置两个不同信道的WiFi（主路由 + 备用AP），以防单个热点拥堵或重启。
设备离线时，业务服务器应缓存待执行指令，待设备重新上线后通过API补发。
本地局域网直连（降级方案）
芯步支持纯局域网环境运行。如果公网断开，但内网正常，你的业务服务器可以通过设备的本地IP直接下发指令：
POST http://192.168.1.100:8080/control实现技巧：在数据库中存储设备的
local_ip，当云API超时或不可用时，自动切换至局域网API模式。
5. 方案实施流程图（文字说明）
环境准备：部署35A设备到电箱，接入零火线，连接2.4G WiFi。
基础配置：芯步管理后台注册设备，获取
device_id与API Key。协议对接：开发人员封装HTTP请求库，完成本地测试开关的
ON/OFF。业务集成
前端页面调用后端接口。
用户点击“定时设置”，选择时间点（例如：周一至周五 08:00 开，18:00 关）。
后端接收请求，写入任务表，计算下一次执行时间。
自动化执行
守护进程轮询任务表。
时间到 -> 调用API -> 设备动作 -> 记录日志。
运维监控：建立可视化看板，展示35A设备当前状态及最近一次动作结果。
6. 总结
通过对接芯步35A智能电源保护开关的开放接口，开发者可以在3天内完成从配网到定时控制系统的基本搭建。该方案的核心优势在于轻量级（无需网关）、接口友好（标准HTTP）以及支持局域网直连。结合业务层的定时调度逻辑，即可实现稳定、精确的远程电源管理解决方案。