开放接口并支持二次开发的智能 24 路分体远程线路管理控制器
浏览:386 次
芯步工厂提供的 智能分体控制器 开放HTTP接口, 适用于任何支持HTTP请求的编程语言。 接口简单、清晰、友好, 仅需在接口携带签名、以及设备ID,即可向设备下发命令。 支持接入任何形式的软件项目:Web、APP / 小程序、窗体软件、以及SaaS / 低代码等平台。
本文介绍了智能分体控制器的相关参数和命令,并在下面提供了主要类型的语言的编程示例。
智能分体控制器
高集成度控制器,独立控制24条线路
主机与继电器分体式设计,维护扩展方便
除无线外,标配有线网口,网络连接更加稳定
搭配继电器模块使用,接线方便简单
适用场景
共享台球厅多线路集中控制、共享自习室灯光电源控制、运动场馆多路设备控制、共享棋牌室多设备集中管理、共享茶室电器线路控制、无人值守设备机房电源管理、门店照明系统集中控制、智能家居多路电器控制、办公设备电源集中管理、自助设备多线路控制、充电桩多路输出控制、大功率设备集中控制、厂房多设备集中控制、生产车间多设备联动控制、实验室多设备分路控制、智能化改造、自动售货柜控制、灯光控制、照明控制、便利店灯光控制、店铺招牌控制、展柜设备控制、仓储照明控制、楼宇公共照明、弱电间设备管理、民宿多设备联动、共享设备柜控制、自助储物柜控制、社区智能设施控制、机房设备控制、餐饮后厨设备控制、无人售货机控制、配电柜智能改造、工业自动化设备控制、产线设备控制、车间设备远程管理、共享自习室灯光设备控制、共享棋牌室设备电源控制、共享台球室灯光空调控制、共享茶室设备电源管理、自助洗车设备线路控制、快递柜设备控制、校园公共照明控制、停车场灯光设备控制、商场展柜电源控制、酒店客房设备集中控制、实验室多设备联动控制、教研实训设备远程管理、创客项目设备电源控制、写字楼公共区域照明控制、养老社区公共设备控制、仓储物流设备电源管理、景观灯光远程控制、户外亮化工程控制中
支持命令
| 线路1 | power1 |
| 线路2 | power2 |
| 线路3 | power3 |
| 线路4 | power4 |
| 线路5 | power5 |
| 线路6 | power6 |
| 线路7 | power7 |
| 线路8 | power8 |
| 线路9 | power9 |
| 线路10 | power10 |
| 线路11 | power11 |
| 线路12 | power12 |
| 线路13 | power13 |
| 线路14 | power14 |
| 线路15 | power15 |
| 线路16 | power16 |
| 线路17 | power17 |
| 线路18 | power18 |
| 线路19 | power19 |
| 线路20 | power20 |
| 线路21 | power21 |
| 线路22 | power22 |
| 线路23 | power23 |
| 线路24 | power24 |
| 批量控制 | batch |
| 先通后断 | point |
| 先断后通 | reset |
产品手册
| 版本 | 对应产品手册 |
|---|---|
| 24路 / 有线 | 《智能分体控制器产品手册》 |
控制设备,向设备下发指令
HTTP请求地址: http(s)://api.yoyoiot.cn/{AppID}/device/control/?sign={sign}&ts={ts}
关于sign和ts的定义
或
MQTT发布主题: api/{AppID}/device/control
接收返回结果亦在同一主题
请求参数
参数较长时建议使用POST方式
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| gateway | 否 | string | 当发给设备的命令需要其关联的网关转发时,需要指定
网关的设备ID,唯一ID(在网关壳体上、控制台均可以找到)
指定多个网关时请用间隔符(,或|)连接,最多可以同时指定5台网关 |
| device | 是 | string | 设备ID,设备唯一ID(在设备壳体上、控制台均可以找到)
指定多台设备时请用间隔符(,或|)连接
指定多个设备时,不要这些设备属于同一类产品,但必须有相同的指令 |
| order | 是 | string | 命令,可传JSON字符串(推荐)或直接传参
简单命令:可直接GET或POST:设备的属性名称=属性值
复杂或较长的命令:请POST {"order":{命令内容}}
-----------------------------------------------------------------------
在一些业务场景,需要在命令里携带一些特征信息:如订单号等
可在order中增加一个字段extra,如{"power":1,"extra":"T25030700001"}
在本条命令对应的异步消息推送中,会原样返回此特征信息。
extra只支持32位以内的大小写英文字母和数字(a-zA-Z0-9) |
返回示例
x
1
//示例2
//device为设备唯一id3
//p1、p2为参数名称,v1、v2为参数的值4
5
//GET方式的参数为:6
?device=123456&p1=v1&p2=v2&sign={sign}&ts={ts}7
8
//POST方式的FORM参数为:9
device=12345610
p1=v111
p2=v212
13
//POST方式的JSON参数为:14
{"device":111,"order":{"p1":"v1","p2":"v2"}}返回结果
需要注意的是,200仅代表平台接收到了合规的设备ID与参数名称,并成功向设备下发命令。
而设备可能已离线,或命令内容 / 参数有误,在设备上并没有看到预期效果。
在一些必须要求反馈的场景,请接收云端的消息推送,通过异步消息来标记设备是否成功执行命令。
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 200 命令下发成功。
501 未指定设备ID,设备ID为一个整型数字,或由“|”或“,"连接的多个数字。设备列表接口中输出了此ID,在本控制台的设备列表中也可以查看。
502 设备不存在或没有可用设备,传入设备ID均不存在。请检查设备ID是否正确,设备是否删除。
503 指定了过多设备,一次最多指定100台设备ID
504 一次指定了多个设备ID,但其中有一些并不可用(不存在、无权限或已删除)
50xx 请见“全局错误代码” |
返回示例