芯步的智能空调遥控器通过HTTP接口开放了完整的空调控制能力，包括开关、模式、温度、风速等。以下方案以“空调模式切换”为核心，涵盖接口协议、签名算法、请求示例及常见问题处理，帮助开发者快速完成对接。
主题：如何利用开放接口实现空调模式切换控制
1. 解决概述
对于拥有本地服务器的开发者或集成商，通过芯步提供的开放 HTTP 接口，可以非常便捷地将空调控制器集成到现有的 Web 应用、移动端 App 或物业管理系统中。
本方案主要针对 智能空调遥控器 产品。该设备通过红外信号覆盖市面上绝大多数分体式空调。开发者无需改造空调线路，只需发送 HTTP 请求即可模拟物理遥控器的按键指令，实现空调的开关、模式切换（制冷/制热/送风/除湿）、温度调节及风速调整。
2. 对接前准备
在开始编码前，请确保完成以下准备工作：
硬件准备：购买并安装芯步“智能空调遥控器”设备，并确保其处于在线状态（通常为绿灯常亮）。
获取凭证：登录芯步开放平台控制台，创建应用以获取
AppID和AppSecret（开发者密码）。这两个参数是后续接口鉴权的核心。获取设备ID：在控制台设备列表页面，查看已绑定的空调控制器
Device ID（设备编号）。
3. 接口鉴权与请求模型
芯步的 HTTP 接口采用 RESTful 风格，支持公网通信。所有控制指令均需通过签名验证，以确保安全性。
3.1 请求地址
POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}3.2 鉴权参数详解
为了杜绝非法请求，系统使用 sign 和 ts 进行双重校验，计算方法如下
ts (时间戳)：当前的 Unix 时间戳（秒级）。例如：
1714550400。sign (签名)
计算规则：
sign = MD5( MD5(AppSecret) + ts )注意
MD5(AppSecret)得到的是 32 位小写字符串，拼接上ts对应的字符串后，再进行一次 MD5 加密。
安全提示：客户端和服务器时间误差不宜过大，否则会验签失败。
4. 核心功能：空调模式切换实现
本节是解决方案的核心，详细说明如何通过 HTTP 接口将空调从“制热”切换为“制冷”或调节温度。
4.1 请求头设置
4.2 请求体参数
device：传入你的空调控制器设备 ID（支持批量，用逗号分隔）。
order：JSON 字符串，包含具体的空调指令。
4.3 空调控制命令集
芯步的空调控制器指令非常直观，与遥控器按键一一对应
| 功能类别 | 指令示例 (JSON格式) | 功能描述 |
|---|---|---|
| 切换模式 | {"mode":"3"} | 将空调模式切换至“制热”模式。 |
| 温度调节 | {"temp":"26"} | 设定目标温度为 26℃。 |
| 风速调节 | {"windspeed":"2"} | 设定风速为中风（通常支持自动、低、中、高）。 |
| 开关机 | {"power":"1"} | 开机（1为开，0为关）。 |
模式参数值（mode）对照表
| 数值 | 模式 | 适用场景 |
|---|---|---|
| 1 | 送风 | 通风换气 |
| 2 | 除湿 | 梅雨季/潮湿环境 |
| 3 | 制热 | 冬季取暖 |
| 4 | 制冷 | 夏季降温 |
4.4 实战代码示例：实现模式切换
以下以 切换至制冷模式并设置温度为20度 为例，演示如何使用通用 HTTP 指令实现。
1. 构造签名假设 AppSecret 为 abc123，ts 为 1714550400
MD5(AppSecret)=e99a18c428cb38d5f260853678922e03拼接 ts 值：
e99a18c428cb38d5f260853678922e03+1714550400=e99a18c428cb38d5f260853678922e031714550400计算最终 sign：
MD5(上述字符串)=a1b2c3d4e5f678901234567890abcdef（仅为示例）
2. 发送 HTTP 请求
进阶技巧：如果需要批量控制多台空调实现全楼宇的模式统一切换，device 字段支持传入数组格式，例如 "device": "100001,100002,100003"。
5. 状态同步与反馈机制
由于红外控制具有“单向通信”的特性（设备发出信号后无法自反馈空调是否真的执行成功），采用以下策略保证系统状态的准确性：
乐观锁与日志：发送指令后，接收接口返回的
code（如200即代表指令已成功下发给红外设备），在前端界面即时更新状态。环境传感器联动：为了确认“制冷”是否生效，结合芯步的温湿度传感器进行闭环控制。通过传感器检测当前室温，当室温降到设定值时，自动发送关机指令，实现节能环保。
6. 常见问题与排查
返回 “sign error”
请检查 ts 是否为当前时间戳（秒级）。
检查 MD5 结果是否为 32位小写。
指令下发成功但空调没反应
原因1：空调未通电或超出了红外遥控范围。
原因2：该型号空调的红外码库可能存在偏差。芯步支持对码功能，可尝试重新匹配遥控器码库。
如何测试指令？
芯步控制台通常提供 API 调试工具，可以直接在网页端输入 AppID 和指令测试，无需编写代码即可验证硬件响应。
7. 总结
芯步提供的 HTTP 接口极大地降低了硬件集成的门槛。通过简单的 mode 和 temp 参数传递，开发者即可在现有业务系统中实现空调的远程模式切换控制。无论是写字楼的集中供暖/供冷切换，还是智能家居的场景联动（如“离家模式”一键关闭所有空调），均可通过上述标准接口稳定实现。