芯步的10A智能插座系列提供标准化的开放HTTP API接口，签名机制简单清晰，通常10-15分钟即可完成对接。以下是基于其官方接口文档整理的完整集成方案。
一、 产品选型与能力评估
在开始集成前，首先需要明确项目中所需的具体硬件形态。芯步提供两种主流的10A插座形态，两者的核心API调用逻辑完全一致，仅在物理安装方式和是否有计量功能上存在差异
智能插座10A（直插式）
型号：UNI-CZ-10A / UNI-CZ-10A-P（计量版）
特点：体积小巧，即插即用，直接插在传统墙壁插座上即可。
适用场景：展柜加装改造、临时布展、不需要改动原有线路的场合。
智能墙壁插座10A（86型）
型号：UNI-QC-10A / UNI-QC-10A-P（计量版）
特点：标准86型底盒，需嵌入墙体安装，外观更整洁。
适用场景：新建展柜项目、高标准展厅装修，追求美观与一体化。
核心集成参数
额定功率：MAX 2200W（阻性负载）/ 若用于LED/电机等感性负载需小于300W。
网络连接：WiFi 2.4GHz（无需网关，直连路由器）。
响应速度：命令下发到执行约 80-120ms。
二、 集成设计
要将智能插座集成到您的“展柜设备电源控制”项目中，采用以下云到端架构：
设备端（智能插座）：连接展柜（如灯光、显示屏、恒温设备）的电源插头，通过WiFi连接至互联网或局域网。
芯步云平台（OpenAPI）：作为中间层，负责处理HTTP请求的下发与设备状态的转发。
您的业务系统/中控软件
公网方案：您的系统调用芯步云端API。
局域网/私有化方案：如果您的展柜项目处于高安全级内网（无外网），插座支持私有化部署，您可以将消息服务器部署在本地服务器，指令完全在局域网内传输。
三、 核心API对接流程
芯步的接口设计非常简洁，无需复杂的SDK，仅需构造HTTP POST请求即可。核心在于 “签名计算”和 “指令下发” 。
第一步：准备工作（获取凭证）
在芯步开发者后台完成以下准备
获取AppID：应用的唯一标识。
获取AppSecret：开发者密码，用于签名计算。
获取Device ID：设备通电配网后，在后台获取该设备的唯一ID。
第二步：签名计算
为了安全，每次请求都需要携带签名。签名算法如下
将 AppSecret 进行 MD5 加密，得到
encrypt_secret。获取当前Unix时间戳（秒）
ts。拼接字符串：
sign_str = encrypt_secret + ts。将
sign_str再次进行 MD5 加密，得到最终的sign。
注：开发测试阶段可在后台开启“调试模式”暂时绕过签名校验，以便快速调试逻辑。
第三步：下发控制指令
这是集成中最核心的一步，通过HTTP请求控制插座的开/关。
请求地址
POST https://api.thingboot.com/{AppId}/device/control/？sign={sign}&ts={ts}请求头
Content-Type： application/jsonBody参数
| 参数 | 类型 | 描述 | 示例 |
|---|---|---|---|
device | String / Int | 设备ID（支持单个或多个用逗号分隔） | “820720” 或 “123，456” |
order | Json Object | 控制命令 | {“power”： 1} |
具体场景指令示例
开启展柜电源
命令内容：
{“power”： 1}（1代表接通电源）。
关闭展柜电源
命令内容：
{“power”： 0}（0代表断开电源）。
一键关闭整个展区的所有插座
利用批量控制，将多个设备ID用逗号拼接。
命令内容：Device参数传
“1001，1002，1003”，Order传{“power”： 0}。
第四步：高级功能集成（定时与计量）
1. 定时开关（自动闭馆/开馆）无需在您的服务器上维护复杂的定时任务队列，插座内置硬件定时功能。您只需下发一条指令即可实现“通电1小时后自动断电”，非常适合展柜演示场景
指令
{“reset”： 3600000}解析
reset代表先断开再接通（或此处常作为临时通电），参数单位为毫秒。上述指令代表立即通电，并在 3600000毫秒（即1小时） 后自动断电。
2. 能耗数据采集（设备运维）如果您采购的是带 -P 后缀的计量版插座，可以通过API获取电流、电压、功率等数据。
业务价值：通过监测展柜设备的实时功率，可以判断设备是否故障（如功率为0可能死机，功率异常升高可能短路），实现主动式运维告警。
四、 集成代码示例
这里展示如何在一个Shell脚本中控制展柜照明（亦可用Python/Java/Go等任何语言实现）：
五、 集成注意事项
关于指示灯与按钮
插座上的物理按钮支持动作自定义。在展馆场景下，在API中配置为屏蔽物理按键，防止参观游客或保洁人员误触导致展柜断电。
网络策略
如果展厅WiFi信号复杂，设备支持配置5组WiFi，会自动切换最强信号。
对于高安全级项目，请一定要采用私有化部署方案，确保电源控制指令不经过外网，仅在内网传输。
负载安全
虽然是10A规格，但如果展柜使用的是电机类设备（如旋转展台）或LED大屏，启动瞬间电流较大，降额使用（不超过300W-1000W），或选用16A版本。
通过以上步骤，您可以快速将芯步的10A智能插座无感集成到展柜控制系统中，实现远程开关、自动定时与能耗监控。