设备分组API使用教程

文档编辑

概述

设备分组接口可以对多个设备进行分组，只要往分组里面发送指令，做到同时控制一个分组下的多个设备。

要使用该设备分组接口，必须创建分组。创建分组以后根据MAC地址绑定设备，再根据设备日志MAC地址对应的did将设备加进一个分组里面，再往分组里面发送指令，设备收到指令并作出反应，就完成了设备分组。

使用例子，如：一个公司有多个部门，每个部门有多盏智能灯。每天早上一个部门来人了，就可以只打开该部门的智能灯。每天晚上一个部门的人都走光了，就可以只关闭该部门的智能灯。

设备分组API使用流程

Open API的设备分组接口，就是对多个设备分组并进行控制。当开发者/企业客户设置好openAPI设备分组接口后，就可以调用该接口把多个设备加入到分组，做到分组控制多个设备。

1.打开机智云官网文档中心->云API->OPEN API指南，下拉点击调试接口

2.点击设备分组->创建分组

3.点击创建分组->感叹号，填写App ID和token，这两个参数可以参考文档《利用openapi（postman）控制虚拟设备》中“2.3新建应用配置”和“3. Postman安装和导入”，参考文档链接http://docs.gizwits.com/zh-cn/UserManual/UseOpenAPI.html

4.填写App ID和token之后，填写body

5.得到分组id后，我们可以查看一下组里面有没有设备

6.根据MAC绑定设备

Timestamp获取链接http://tool.chinaz.com/Tools/unixtime.aspx

Signature获取链接http://tool.chinaz.com/Tools/md5.aspx

绑定设备成功以后会返回一个如下的响应体

7.绑定设备以后，我们回到设备分组，将设备添加到分组

8.查看设备日志

9.成功添加设备到分组以后会返回如下响应体

10.然后我们就可以针对设备分组发送指令远程控制设备

11.这样我们就可以控制一个分组中的一个设备（RGB灯亮灭），按照同种方法添加多个设备到一个分组中，我们就可以同时控制一个分组中的多个设备。