CATALOG

芯步的智能硬件都开放了HTTP接口,说白了就是只要你懂一点编程(或者让AI帮你写),对着他们的服务器发个指令就能控制灯了。下面我把整个过程拆解了一下,你跟着一步步走就行。

一、 咱们得先选个“听使唤”的硬件

要实现远程控制一盏灯,首先得选对设备。芯步的产品线里,好几款都能干这活儿,你可以根据实际场景挑:

  • 智能墙壁开关(1路/2路/3路):这个最直接,直接替换家里的86型墙壁开关就行。如果你是想改造家里或者办公室的现有墙壁开关,选这个最合适,不用改线路,把原来的开关卸下来,把这个换上即可

  • 智能照明控制器(如4路):这个通常是个“盒子”,藏在配电箱或者设备柜里。如果你是想集中控制好几路灯光(比如控制整个展厅的4组灯),或者灯具功率比较大,用这个更专业、更稳

核心思路:不管选哪个,它们都支持HTTP接口。只要设备连上了Wi-Fi,能上网,你就能控制它。

二、 动手前的“钥匙”准备(其实就两步)

在写代码之前,得先去芯步的后台拿两样东西,这就好比进家门的钥匙。

  1. 注册账号,添加设备:去芯步官网注册个账号,在“物联网控制台”里先把你的设备(比如那个墙壁开关)添加进来,给Wi-Fi配上网。这一步通常用他们的App或者小程序就能搞定,很简单

  2. 找到你的密钥(AppID & AppSecret):在控制台的“开发设置”里,找到 AppIDAppSecret

    • AppID 就像是“用户名”,告诉服务器你是谁。

    • AppSecret 就像是“密码”,这个要藏好,不能泄露。

特别注意:芯步的接口为了安全,调用的时候需要加一个动态签名。这个签名的算法是 md5( md5(AppSecret) + ts )听着有点绕口?别怕,其实就是:把你的 AppSecret 先MD5加密一次,得到一个字符串,然后把这个字符串和当前的时间戳拼在一起,再把拼好的这个字符串整体MD5加密一次。

为了让你不迷糊,我给你看个伪代码逻辑(后面有现成的命令):(假设你的 AppSecret 是 “abc123”,当前时间戳 ts 是 “1678900000”)

  1. 先算 step1 = md5(“abc123”) -> 得到 e99a18c428cb38d5f22e03...

  2. 再算 sign = md5( step1 + “1678900000” ) -> 这就是你要的签名。

三、 核心操作:发个“开灯”指令

好了,钥匙拿好了,设备也通电了,咱们来发指令。芯步的接口地址是统一的

请求地址https://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={当前时间戳}

请求方式:POST

数据格式:JSON

我们要控制的是一盏灯,也就是设备里的“第一路”。假设你的设备ID是 123456,你想开灯。

这时候,order 参数里要传 {“power1”: “1”}

  • power1 代表第一路。

  • “1” 代表开,“0” 代表关。

1. 如果你会用电脑(Linux/Mac),直接复制这段 Shell 代码试试:

这是最直接的方法,你打开终端(命令行),把下面的代码复制进去,改一下几个参数就行

如果你想把灯关掉,只需要把最后一行里的 “1” 改成 “0” 就行了。

2. 如果你想集成到自己的 App 或网页里(通用写法)

不管你用啥编程语言,原理都是发这样一个 HTTP 请求

请求体内容

如果你的设备是一个 3路开关,想同时把三盏灯都打开,那 order 就这样写

四、 进阶玩法:不只是“开”和“关”

芯步的接口还支持一些好用的“模式”,不仅仅是简单的通电断电。

  • 定时关(先通后断):有时候你只想开一会儿灯,比如开2秒然后自动关。适合做门禁联动或者警报闪烁。发送 {“point1”: “2000”} 就行了(单位是毫秒)

  • 状态恢复(防手贱):比如在自习室或酒店,你想强制灯必须是关的,客人按开10秒后,系统自动给它又关了。可以用 {“power1”: {“keep”: “0”, “revert”: “10”}}

五、 要是没外网怎么办?(局域网/私有化)

这算是芯步一个挺好的优点。如果你不想经过外网,或者环境里没有互联网(比如一些保密单位或工业厂房),他们支持私有化部署

你可以把消息服务器搭在自己局域网的电脑上,设备也只在内网通信,不经过云端,这样响应速度会更快,数据也更安全

总结一下流程

  1. 买设备:买个智能墙壁开关(1路)或者控制器。

  2. 装设备:替换墙上开关,接好线,连上Wi-Fi。

  3. 拿密钥:在芯步后台拿到 AppID 和 AppSecret。

  4. 算签名:按照规则 md5(md5(密钥)+时间戳) 算出签名。

  5. 发指令:用 POST 方式请求接口,Body 里带上 deviceorder{“power1”: “1”})。

搞定了这一步,你不仅能在手机上开关灯,甚至可以在电脑上设个定时任务,或者做个语音助手,喊一嗓子就把灯关了。希望这个对你有帮助!