店铺设备电源管理：怎样将1位5孔远程控制插座接入到软件项目中_解决方案

CATALOG

芯步的智能插座开放标准HTTP API接口，支持远程控制和状态监控，可以快速集成到各类软件项目中。以下方案以1位5孔墙壁插座为例，涵盖设备配网、API调用、签名计算到项目集成的完整流程。

1. 背景与目标

在店铺运营场景中，对广告灯箱、展示橱窗、收银系统、音响设备等进行有效的电源管理，不仅能延长设备寿命，更能实现节能减排和远程无人化管理。本方案的目标是指导开发者如何将芯步的 1位5孔远程控制插座（86型墙壁插座）通过其开放的API接口，快速接入现有的软件项目（如店铺管理系统、小程序或Web应用），实现对店铺各处电源的远程通断控制、状态查询及定时任务管理。

2. 选定产品与技术特性

本次方案选型基于芯步的 86型智能墙壁插座（1位5孔，16A带计量版）。

核心优势：该设备采用标准86型底盒设计，可直接替换店铺原有墙面插座，无需改线，安装便捷。
通信机制：设备直连 WiFi 2.4GHz 网络，无需额外网关，降低了硬件成本和故障点。
开放能力：设备开放完整的 HTTP API接口，这意味着无论你的后台是Java、Python、PHP还是前端JavaScript，只要支持HTTP请求，即可完成控制。
扩展功能：支持电量计量（计量版），可实时监测设备功率和用电量，便于店铺进行能耗分析。

3. 接口对接流程（软件集成核心）

将插座接入软件项目主要分为三个步骤：获取密钥、设备配网、API调用。

3.1 准备工作：获取凭证

在开始编码前，你需要在芯步开放平台获取以下信息：

AppID：应用的唯一标识。
AppSecret：开发者密码，用于生成签名，确保接口安全。
Device ID：设备唯一ID，贴在设备外壳上，或在控制台扫码添加后获得。

3.2 设备配网（零配模式）

要让插座连接上店铺的WiFi，通常通过“设备热点配网”或“小程序配网”完成。对于软件项目集成，配网通常由项目实施人员通过官方的小程序或控制台一次性完成：

手机连接设备发出的热点。
在App/小程序中输入店铺的WiFi名和密码（仅支持2.4G频段）。
设备自动重启并连接至云端。注：配网成功后，设备在云端处于“在线”状态，即可接收API指令。

3.3 API签名算法（Sign生成）

这是接口调用的核心安全机制。 芯步的接口请求必须在URL中携带sign（签名）和ts（时间戳）。签名生成逻辑如下

获取当前时间戳（ts）：精确到秒的10位数字。
计算第一步MD5md5_one = md5(AppSecret)
拼接字符串str = md5_one + ts
计算最终签名sign = md5(str)

3.4 核心接口调用：下发控制指令

这是项目中调用最频繁的接口，用于控制插座的开启与关闭。

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方式POST (推荐，参数较长时使用)
请求头Content-Type: application/json
请求体 (JSON)

返回示例

注意：返回200仅表示平台接收了指令，若需确认设备实际是否动作，通过消息推送（Webhook）接收设备状态回执。

4. 软件项目集成实战（代码示例）

以下将演示如何在你的软件后端（以Python和JavaScript为例）封装一个简单的设备控制函数。

4.1 Python 集成示例（适用于Django/Flask后端）

import hashlib
import time
import requests
import json

class YoYoIOT:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_url = f"https://api.thingboot.com/{app_id}/device/control/"

def generate_sign(self, ts):
        # 1. 第一次MD5
        md5_one = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 拼接 + 第二次MD5
        sign_str = md5_one + str(ts)
        final_sign = hashlib.md5(sign_str.encode()).hexdigest()
        return final_sign

def control_device(self, device_id, power_status):
        ts = int(time.time())
        sign = self.generate_sign(ts)
        
        # 构建请求参数
        params = {
            'sign': sign,
            'ts': ts
        }
        payload = {
            'device': device_id,
            'order': {'power': power_status}  # 1开 0关
        }
        
        response = requests.post(self.api_url, params=params, json=payload)
        return response.json()

# 使用示例
iot = YoYoIOT('你的AppID', '你的AppSecret')
# 关闭店铺打烊模式，关闭插座
result = iot.control_device('123456789', 0)
print(result)

4.2 JavaScript/Node.js 集成示例（适用于小程序或Web管理后台）

const crypto = require('crypto');

class ThingBoot {
    constructor(appId, appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
    }

generateSign(ts) {
        // 计算第一次MD5
        const md5One = crypto.createHash('md5').update(this.appSecret).digest('hex');
        // 拼接并计算第二次MD5
        const signStr = md5One + ts;
        return crypto.createHash('md5').update(signStr).digest('hex');
    }

async controlDevice(deviceId, powerOn) {
        const ts = Math.floor(Date.now() / 1000);
        const sign = this.generateSign(ts);

5. 集成进阶：高级功能与状态同步

除了简单的“开/关”，为了打造完善的店铺管理系统，利用以下扩展接口：

5.1 获取设备状态（电量与功率）

针对带计量版的插座，芯步支持通过消息回调或查询接口获取实时数据。这在分析店铺设备（如冰柜、咖啡机）的运行状态时非常有用。

应用场景：后台大屏展示当前店铺总功率，若功率异常突降，可推断设备故障或跳闸。

5.2 定时任务与自动化

虽然可以通过你的软件服务器定时发送指令，但为了减少服务器压力和提高响应速度，可以直接调用芯步的 定时任务接口，将定时规则保存在云端，即使断网也能执行。

应用场景：设置店铺“每日22:00自动关闭招牌灯箱，每日08:00自动打开收银台插座”。

5.3 接收设备状态推送（Webhook）

为了避免频繁轮询，你可以配置一个接收URL（Webhook）。当插座状态发生变化（被物理按键按下或因过载保护断开）时，芯步平台会主动推送消息到你的服务器。

应用场景：实时记录店员触碰开关的操作日志，或检测到插座离线时立即发送告警通知店长。

6. 总结

通过上述方案，开发者仅需具备基础的HTTP请求能力，即可在 1小时 内完成芯步1位5孔智能插座的软件集成对接。

低成本：无需网关，直接WiFi连接。
高灵活性：HTTP接口通用性强，支持私有化部署和局域网直连，保障数据安全。
可扩展：接口统一，集成成功后，可无缝管理该平台下的其他传感器或通断器设备。

该方案不仅能解决店铺的电源远程管理问题，更为后续实现全面的能耗监测和自动化场景打下了坚实的基础。