开放接口并支持对接的8路包间设备集中控制器
浏览：131 次
芯步工厂提供的 智能包间控制器|Max 开放HTTP接口， 适用于任何支持HTTP请求的编程语言。 接口简单、清晰、友好， 仅需在接口携带签名、以及设备ID，即可向设备下发命令。 支持接入任何形式的软件项目：Web、APP / 小程序、窗体软件、以及SaaS / 低代码等平台。
本文介绍了智能包间控制器|Max的相关参数和命令，并在下面提供了主要类型的语言的编程示例。
智能包间控制器|Max
服务型门店包间专用，二代升级版本，更大功率输出；
广泛应用于共享棋牌室、茶室、休息室、舞蹈练习室、琴房、沐浴房等场景；
第1、2、3路为10A开关，或接照明或换气扇、吸烟灯等电器；
第4、5、6路为16A插座接口，可接饮水机、麻将机、按摩仪等电器；
第7路为10A门禁电磁锁接口，可接任何直流电磁锁和电插锁；
第8路为30A插座接口，可接2匹空调；
共提供8路输出，可完全覆盖包间内所有电器；
所有线路（输出接口）均可通过HTTP接口远程独立控制通断；
TTS版本支持远程语音播报，可用在订单提醒或服务说明；
支持远程定时任务，支持自定义联动操作；
适用场景
共享棋牌室包间控制、共享茶室包间控制、共享自习室包间管理、共享台球室包间控制、舞蹈练习室设备管理、琴房设备控制、沐浴房场景控制、门店包间设备电源管理、无人值守包间设备控制、线下服务门店包间管理、KTV 包间设备集中控制、私人影院包间场景、网咖电竞包间管理、棋牌室包间电源控制、共享茶室包间预约联动、共享自习室独立包间控制、酒店客房包间场景、足浴按摩店包间控制、餐厅独立包间灯光管理、剧本杀密室包间场景、轰趴馆多功能包间控制、企业会议室包间管理、录音棚隔音包间控制、直播间独立包间场景、VR 体验馆包间设备控制、台球厅 VIP 包间管理、私人 K 歌房包间控制、洗浴中心休息包间场景、月子中心独立包间控制、高端会所包间设备管理、健身房私教包间控制、共享办公独立包间场景、电竞酒店包间联动控制、主题酒店特色包间管理、无人值守自助包间控制中
支持命令
| 线路1 | power1 |
| 线路2 | power2 |
| 线路3 | power3 |
| 线路4 | power4 |
| 线路5 | power5 |
| 线路6 | power6 |
| 线路7 | power7 |
| 线路8 | power8 |
| 批量控制 | batch |
| 先通后断 | point |
| 先断后通 | reset |
产品手册
| 版本 | 对应产品手册 |
|---|---|
| 语音播报:不带 | 《智能包间控制器Max产品手册》 |
| 语音播报:带 | 《智能包间控制器Max[TTS版]产品手册》 |
控制设备，向设备下发指令
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 请见“全局错误代码” |
返回示例
