4路智能包间控制器MINI：怎样把4路HTTP接口包间控制器MINI对接到项目中_解决方案

CATALOG

4路HTTP接口包间控制器MINI是专为共享棋牌室、茶室等场景设计的智能设备，支持单个和批量控制、TTS语音播报、场景联动等功能。本文将从前期准备、签名算法、核心接口调用、状态同步、典型场景实现到注意事项，系统讲解如何将其快速集成到你的项目中。

在编写任何代码之前，你需要完成以下三个步骤，获取对接所需的唯一凭证：

硬件就位
- 确保控制器通电，并通过网线或2.4GHz Wi-Fi联网。
- 在设备标签上找到 设备ID (Device ID)，这是你需要记录的唯一标识。
注册/登录芯步开放平台
- 访问芯步官网，进入物联网控制台。
获取密钥 (AppID & AppSecret)
- 在控制台的“开发设置”页面，创建应用以获取 AppID 和 AppSecret。
- 注意：AppSecret 仅在创建时可见，请妥善保管。

所有HTTP接口请求都需要携带签名以确保安全。芯步的签名算法稍特殊，是“双重MD5加密 + 时间戳”。

签名公式Sign = MD5( MD5(AppSecret) + ts )

参数说明

计算步骤拆解（以伪代码为例）

代码示例（JavaScript/Node.js）

注意：不同编程语言（Python/Java/PHP）的加密库函数名可能不同，但逻辑一致。

API请求地址格式如下：https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={ts}

请求方式：POST请求头 (Header)Content-Type: application/json

这是最常用的功能。比如你需要在用户下单后，自动打开包间的总电（第1路）。

请求体 (Body)

比如“清场”时，你需要关闭所有设备。

请求体 (Body)

如果你购买的是TTS版本，可以利用语音功能提升用户体验。例如当顾客呼叫服务时，播报“XX包间需要服务”。

请求体 (Body)

单纯的发指令是不够的，你需要知道设备当前是开还是关（同步状态）。

方案一：主动查询（获取设备状态）如果你只需要偶尔查看状态，可以调用“获取设备信息”接口（具体路径见官方API文档），通过传入Device ID获取当前属性值。

方案二：被动接收（消息推送）- 推荐为了实时性，强烈配置消息推送回调。

场景：共享棋牌室/茶室的自动化流程

用户下单
- 用户在微信小程序支付成功。
- 你的后端动作
  - 调用接口：{"device": "A区05房", "order": {"power1": 1}} (打开总电)。
  - 调用接口：{"device": "A区05房", "order": {"power4": 1}} (打开空调)。
  - 调用TTS接口：播报“欢迎光临，祝您娱乐愉快”。
用户呼叫服务
- 包间内无物理按钮时，通过你小程序内的“呼叫”按钮。
- 你的后端动作：找到该包间对应的设备ID，下发TTS指令：{"play:gbk:16": "03号包间需要茶水服务"}。
时间到/自动断电
- 订单倒计时结束，或用户提前点击“退租”。
- 你的后端动作
  - 调用接口：{"device": "A区05房", "order": {"power": 0}} (全关)。
  - 安全提示：空调（第4路，30A）通常设置延时关机或软关机，避免直接切断大功率设备影响寿命。

签名失败 (sign invalid)
- 99%的错误是时间戳 ts 不对。服务器通常会校验时间戳的有效期（如5分钟内），请确保你的服务器时间与标准时间同步。
- 双重MD5顺序不要搞反。
设备离线 (Device Offline)
- 控制器仅支持 2.4GHz Wi-Fi，不支持5G频段。
- 检查DC 5V供电是否稳定。
局域网还是公网？
- 芯步默认走公网云，设备无需与服务器在同一局域网，只要有网就能控。
- 如果你有私有化需求（数据不出局域网），该设备也支持局域网IP直连控制，具体指令格式请参考《私有化部署文档》。
负载安全提醒
- 第1/2路最大3500W。
- 第4路最大6600W（专供空调）。
- 强烈：对接时，请在代码中做好限制，禁止将高功率电器（如空调）插到低功率接口上。