芯步的智能空调遥控器2通过开放HTTP接口,可以让你用任何支持HTTP请求的编程语言,快速实现手机APP远程控制空调。整个接入流程分为准备、配置、开发三个主要阶段,下面逐一说明。
1. 准备工作:获取凭证与设备
在开始编码前,需要完成账号注册和设备就绪这两项基础工作。
注册与登录:首先访问芯步官网,使用手机号一键注册并登录。登录后,进入工作台的“物联网控制台”,这里是管理所有设备和接口的核心区域。
获取密钥:在控制台的左侧导航栏找到“开发设置”,系统会为你生成一个开发者ID(AppID)。你需要在这里设置并记录下开发者密码(AppSecret),后续接口调用中的签名将以此计算。如果是首次测试,可以暂时打开“调试模式”,该模式下系统会暂时跳过签名的校验,方便快速验证功能。
设备配网:为“智能空调遥控器2”接通电源。设备使用2.4G WiFi网络,无需额外网关。参考产品手册中的配网指引,通过APP或配网工具将设备连接至你的本地Wi-Fi网络,确保设备联网成功后,在控制台的设备列表中能看到它上线。
2. 核心对接:接口调用与签名计算
这是技术集成的关键环节。芯步的开放接口设计统一,只要封装好一个调用函数,便能控制所有设备。
接口地址与方式你需要向以下API地址发送HTTP POST请求(此处为示例地址,具体以官网文档为准)POST https://api.thingboot.com/{AppID}/device/control
请求参数详解请求需要包含必要的系统参数(验证身份)和设备参数(具体指令):
系统参数(URL参数)
sign(签名):为了安全,你需要对请求进行签名。通常是将
AppID、ts(时间戳)、AppSecret等按特定顺序拼接后,进行MD5或哈希计算得到。如果开启了“调试模式”,此参数可暂时忽略。ts(时间戳):当前Unix时间戳(秒或毫秒级),用于防止请求被恶意重放。
设备指令(Body参数)
device:你想控制的空调对应的唯一设备ID,可在控制台的设备详情页复制。
order:这是一个JSON字符串,包含了具体的控制指令。
order参数支持的控制指令如下表所示:
| 功能 | 指令JSON示例 (order参数) | 说明 |
|---|---|---|
| 开关机 | {"power":"1"} | 打开空调 (1为开,0为关) |
| 设置模式 | {"mode":"cool"} | 模式可选:cool(制冷)、heat(制热)、auto(自动)、fan(送风) |
| 调节温度 | {"temp":"26"} | 设置目标温度,通常范围为16-30℃ |
| 设置风速 | {"windspeed":"auto"} | 风速可选:auto(自动)、low(低风)、mid(中风)、high(高风) |
编程调用示例以下是一个伪代码示例,展示了如何在服务端构造请求控制空调开启制冷模式:
3. 进阶应用:从“遥控”到“智控”
成功通过接口下发指令只是第一步。借助这套开放能力,可以在APP中实现更丰富的产品功能:
设备状态同步:通过芯步提供的其他查询接口或回调机制,获取空调当前的实时状态(如当前室温、是否正在运行),让APP显示的信息与家里实际设备状态保持同步。
定时与场景联动:在APP的业务后端,可以利用接口实现定时任务。例如,设置“每天晚上10点自动关闭卧室空调”。更进一步,可以把空调和其他芯步设备(如门磁、温湿度传感器)联动,构成“离家一键关空调”、“温度高于28度自动开机制冷”等自动化场景。
局域网私有化部署:如果对数据安全和响应速度有比较高要求,智能空调遥控器2支持私有化部署。可以将接口服务运行在本地局域网内,APP在连接家庭Wi-Fi时,指令将不经过云端,直接在局域网内发送,更加稳定和安全。
在整个开发过程中,如果遇到任何对接问题,可以随时联系芯步的技术工程师寻求支持。