神奇的【设备联动API】，助力智能家电场景化
本帖最后由 机智小子 于 2017-5-4 09:22 编辑设备联动API顾名思义就是能让不同设备联动的API。换句话说：在某个场景下，你希望打开门的同时会灯光会自动亮起来！你希望室内温度超过28度以后就能自动打开空调！你希望下雨天窗户能自动关闭晴天窗户能自动打开 ！。。。。。等等，调用设备联动API即可轻松实现这些场景啦。有没有觉得很便利啊！！！ 下面教授大家如何使用这个设备联动API。使用之前，你需注意的是：
[*]1）设备联动API是一个网络请求
[*]2）可在手机端/网页端调用
[*]3）强烈推荐配合Postman使用，当然也可以配合其他网络请求工具使用啦。
设备联动API使用教程
1.概述单品WiFi设备之间联动关系，通过创建设备间联动规则，当设备触发规则后，由云端给要联动的设备推送控制指令。例如：客户有一个智能灯和一个智能空调，可以根据云端提供设备联动功能，创建一个规则，当打开智能灯后，就把智能空调打开。关系图如下http://docs.gizwits.com/assets/zh-cn/UserManual/LinkageAPI/1488352531568.png（注意：创建两个产品联动关系的时候，两个产品一定要关联同一个appid，不然，请求的时候就会报appid不存在问题。
2.设备联动流程条件：原设备和联动设备必须绑定在同一个用户下，然后再在该用户下设定设备联动的规则才能进行设备间的联动功能。
如下就是设备联动的流程图：http://docs.gizwits.com/assets/zh-cn/UserManual/LinkageAPI/1488352498616.png
3.设备联动规则3.1.获取可用变量功能描述：获取可以在创建规则时使用的、跟appid关联的pk下的所有数据点标识名以及设备和产品相关变量。
1.请求URL: http://api.gizwits.com/app/rules/params?product_key=pk1,pk2
2.请求方式: GET
3.请求Header:
3.3.获取用户规则功能描述：获取某个用户创建的所有规则1.请求UR: http://api.gizwits.com/app/rules
2.请求方式:GET
3.请求报文
参数类型必填参数类型描述
X-Gizwits-Application-IdString是Header机智云APPID
X-Gizwits-User-TokenString是Header用户token
3.4.修改规则功能描述：根据rule_id，修改该rule_id下的规则
1.请求URL:http://api.gizwits.com/app/rules/{rule_id}
2.请求方式:PUT
3.请求报文
3.5.删除规则功能描述：根据rule_id，删除该rule_id下的规则
1.请求URL: http://api.gizwits.com/app/rules/{rule_id}
2.请求方式: DELETE
3.请求报文:
参数类型必填参数类型可选值描述
X-Gizwits-Application-IdString是Header机智云APPID
X-Gizwits-User-TokenString是Header用户token
rule_idInteger是url规则号
4.参考资料
Open API文档:http://docs.gizwits.com/zh-cn/Cloud/openapi_apps.html
swagger使用链接:swagger代码太多，只摘取了部分信息。更多内容，请访问：http://docs.gizwits.com/zh-cn/UserManual/LinkageAPI.html
页:
[1]