CATALOG

芯步的接口主打“简单粗暴”——发个HTTP请求就能控制设备。以下方案围绕“1路独立线路控制”这个核心需求,帮你理清从选设备到写代码的全过程。

解决方案:三步走,轻松实现1路独立线路的远程改造

在智能化改造中,如果你只是想远程控制一盏灯一个插座或者一个门锁,没必要搞复杂的PLC或总线系统。利用芯步的开放接口,我们可以用最简单、最互联网的方式(HTTP API)来实现。

别被“API”这三个字母吓到,说白了,它就是一条“网络指令”。只要你的设备能联网(WiFi),你的电脑或手机能上网,你就可以随时发一条指令去控制它。

下面我以 “把家里/公司的灯改成远程控制” 为例,手把手教你怎么玩。

第一步:选对硬件——1路控制的“执行者”

要实现1路独立控制,我们得选一个能听你指令的“开关”。对于大多数只想改造一路照明或者一路普通电器的情况,最推荐的是 【智能墙壁开关1路】

  • 为什么选它? 它长得跟家里的普通开关一模一样,直接替换原来的86型墙壁开关就行,不用改线路,不用动灯具。

  • 它的工作是什么? 它就像一位守在电线上的“门卫”,你的指令(开/关)到了,它就放行(通电)或拦下(断电)。

  • 备选方案: 如果你是工程场景(比如控制广告灯箱、自动售货机),也可以选 【智能控制器1路】 ,功能一样,外观不同

第二步:摸清接口——1路控制的“指挥公式”

设备装好后,它就有了一个身份证(设备ID)。现在我们要学一下怎么给它下命令。

芯步的接口非常“接地气”,用的是标准的HTTP协议。你就想象你是在浏览器里访问一个网址,只不过这个网址带上了你的“钥匙(签名)”和“指令(order)”。

核心接口地址(POST请求):http(s)://api.thingboot.com/{你的AppId}/device/control/?sign={签名}&ts={时间戳}

针对“1路独立控制”的核心参数:

我们关心的就是 order 这个字段里的内容。假设你的设备ID是 123456,想要控制它的第一路(power1)开启或关闭:

  • 开灯(接通):{"power1": 1}

  • 关灯(断开):{"power1": 0}

是不是很简单?power1 代表第一路线路,1 是开,0 是关。如果你买的是2路开关,那第二路就是 power2,以此类推。

第三步:代码实战——用Python发一条指令(稍微口语化的解释)

理论说完了,我们来点实际的。你可以用任何编程语言(Python、Java、PHP,甚至只是用网页工具)来发这条指令。

下面我用写Python代码的思路给你捋一遍,你复制粘贴就能跑通(记得把里面的密钥换成你自己的)。

你需要准备的三个东西:

  1. AppId: 你在芯步后台的账号ID。

  2. AppSecret: 你的账号密码(这个要保密,别泄露)。

  3. Device ID: 你要控制的那台设备编号。

操作逻辑(代码背后的故事):

如果你不用编程:芯步的后台一般有 “API调试工具” ,你把上面的网址和参数复制进去,点一下“发送”,同样能实现控制。

实战场景:让灯在感应到人的时候才亮

有了这个接口,1路独立控制就不再是简单的开关了,你可以玩出花来。比如你想实现 “人来灯亮,人走灯灭”

  1. 硬件搭配: 一路智能开关(控制灯)+ 一个人体存在传感器。

  2. 逻辑联动:

    • 传感器检测到“有人” -> 传感器上报数据给服务器 -> 服务器调用你的控制接口 -> 给开关发送 {"power1": 1} -> 灯亮。

    • 传感器检测到“无人” -> 服务器调用接口 -> 发送 {"power1": 0} -> 灯灭

你只需要写一个非常简单的监听程序,接收传感器发来的“有人/无人”信号,然后根据信号去执行上面的那一小段开关代码即可。

总结

只要弄懂了 “给这个网址发一条包含power1和1/0的指令” ,你就掌握了芯步1路独立控制的精髓。整个过程就像发短信一样简单:你发给服务器说“帮我把设备123456的第一路打开”,然后那边照做,结束。