开放接口并支持二次开发的AC1-10A智能控制器


浏览:887 次

芯步工厂提供的 智能通断器AC1-10A 开放HTTP接口, 适用于任何支持HTTP请求的编程语言。 接口简单、清晰、友好, 仅需在接口携带签名、以及设备ID,即可向设备下发命令。 支持接入任何形式的软件项目:Web、APP / 小程序、窗体软件、以及SaaS / 低代码等平台。

本文介绍了智能通断器AC1-10A的相关参数和命令,并在下面提供了主要类型的语言的编程示例。

智能通断器AC1-10A

适用场景

智能家居照明设备控制、共享场所交流负载管理、智能办公交流电路控制、普通灯具系统交流控制、家电设备电源管理、安防设备交流电路控制、物联网设备交流供电管理、实验室交流负载控制、自动化设备交流电源管理、共享自习室灯光电源控制、共享茶室照明插座控制、共享棋牌室灯光设备控制、共享桌游室灯光空调控制、共享麻将馆灯光插座管理、自助洗车机电路控制、自助售货机电源管理、自助打印机电源控制、自助充电桩线路控制、自助洗衣设备电源管理、共享健身房灯光设备控制、共享球场灯光电源控制、共享场馆照明系统控制、智能家居照明设备控制、共享场所交流负载管理、智能办公交流电路控制、安全节能交流设备管理、普通灯具系统交流控制、家电设备电源管理、安防设备交流电路控制、物联网设备交流供电管理、实验室交流负载控制、自动化设备交流电源管理、共享自习室灯光电源控制、共享茶室照明插座控制、共享棋牌室灯光设备控制、共享桌游室灯光空调控制、共享麻将馆灯光插座管理、自助洗车机电路控制、自助售货机电源管理、自助打印机电源控制、自助充电桩线路控制、自助洗衣设备电源管理、共享健身房灯光设备控制、共享球场灯光电源控制、共享场馆照明系统控制、商业店铺灯光电源管理、办公设备交流电路控制、仓储设备电源控制、酒店客房照明控制、商场展柜电路保护、社区公共设备控制、广告灯箱电路控制、景观亮化工程电源管理、图书馆阅览室电源管理、咖啡厅电器回路保护、便利店收银机电源管理、药店冷藏柜电源控制、共享按摩椅电源控制、自动贩卖机电路管理、充电桩辅助电源控制、智慧工厂产线设备控制、校园公共设备电源管理中

支持命令

线路 power
先通后断 point
先断后通 reset

产品手册

版本对应产品手册
10A 《智能通断器1-10A产品手册》
控制设备,向设备下发指令
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)
返回示例
需要注意的是,200仅代表平台接收到了合规的设备ID与参数名称,并成功向设备下发命令
而设备可能已离线,或命令内容 / 参数有误,在设备上并没有看到预期效果。
在一些必须要求反馈的场景,请接收云端的消息推送,通过异步消息来标记设备是否成功执行命令。

名称 类型 说明
code int
200 命令下发成功。 501 未指定设备ID,设备ID为一个整型数字,或由“|”或“,"连接的多个数字。设备列表接口中输出了此ID,在本控制台的设备列表中也可以查看。 502 设备不存在或没有可用设备,传入设备ID均不存在。请检查设备ID是否正确,设备是否删除。 503 指定了过多设备,一次最多指定100台设备ID 504 一次指定了多个设备ID,但其中有一些并不可用(不存在、无权限或已删除) 50xx 请见“全局错误代码”
返回示例
文章:
相关技术文章:
开放接口并支持对接的2路直流负载控制器

开放接口并支持对接的2路直流负载控制器

查看
开放接口并支持二次开发的2路智能墙壁电源开关

开放接口并支持二次开发的2路智能墙壁电源开关

查看
开放接口并支持二次开发的2路智能墙壁远程控制开关

开放接口并支持二次开发的2路智能墙壁远程控制开关

查看
开放接口并支持对接的60A带计量数显额定 13200W 断路器

开放接口并支持对接的60A带计量数显额定 13200W 断路器

查看
开放接口并支持对接的壁挂式双鉴雷达烟雾报警器

开放接口并支持对接的壁挂式双鉴雷达烟雾报警器

查看