收藏184
分享
阅读41563
更新时间2022-04-11

接口说明
新建设备分组,每个帐号下最多只有1000个分组。
接口调用说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/group/add?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
  "group_name":"test"
}
参数说明
| 参数 | 是否必须 | 说明 | 
| access_token | 是 | 调用接口凭证 | 
| group_name | 是 | 分组名称,不超过100汉字或200个英文字母 | 
返回说明
正常时的返回JSON数据包示例:
{
  "data": {
      "group_id" : 123,
      "group_name" : "test"
  },
  "errcode": 0,
  "errmsg": "success."
}
参数说明
| 参数 | 说明 | 
| group_id | 分组唯一标识,全局唯一 | 
| group_name | 分组名  | 
接口说明
编辑设备分组信息,目前只能修改分组名。
接口调用说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/group/update?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
  "group_id":123,
  "group_name":"test update"
}
参数说明
| 参数 | 是否必须 | 说明 | 
| access_token | 是 | 调用接口凭证 | 
| group_id | 是 | 分组唯一标识,全局唯一 | 
| group_name | 是 | 分组名称,不超过100汉字或200个英文字母 | 
返回说明
正常时的返回JSON数据包示例:
{
  "data": {
  },
  "errcode": 0,
  "errmsg": "success."
}
接口说明
删除设备分组,若分组中还存在设备,则不能删除成功。需把设备移除以后,才能删除。
接口调用说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/group/delete?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
  "group_id":123
}
参数说明
| 参数 | 是否必须 | 说明 | 
| access_token | 是 | 调用接口凭证 | 
| group_id | 是 | 分组唯一标识,全局唯一 | 
返回说明
正常时的返回JSON数据包示例:
{
  "data": {
  },
  "errcode": 0,
  "errmsg": "success."
}
接口说明
查询账号下所有的分组。
接口调用说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/group/getlist?    access_token=ACCESS_TOKEN
POST数据格式:json
POST数据例子:
{
  "begin": 0,
  "count" 10
}
参数说明
| 参数 | 是否必须 | 说明 | 
| access_token | 是 | 调用接口凭证 | 
| begin | 是 | 分组列表的起始索引值 | 
| count | 是 | 待查询的分组数量,不能超过1000个 | 
返回说明
正常时的返回JSON数据包示例:
{
  "data": {
  "total_count": 100,
      "groups":[
       {
          "group_id" : 123,
          "group_name" : "test1"
      },
      {
          "group_id" : 124,
          "group_name" : "test2"
      }
     ]
  },
  "errcode": 0,
  "errmsg": "success."
}
参数说明
| 参数 | 说明 | |
| total_count | 是 | 此账号下现有的总分组数 | 
| groups | 是 | 分组列表 | 
| group_id | 是 | 分组唯一标识,全局唯一 | 
| group_name | 是 | 分组名 | 
接口说明
查询分组详情,包括分组名,分组id,分组里的设备列表。
接口调用说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/group/getdetail?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
  "group_id":123
  "begin":0,
  "count":100
}
参数说明
| 参数 | 是否必须 | 说明 | 
| access_token | 是 | 调用接口凭证 | 
| group_id | 是 | 分组唯一标识,全局唯一 | 
| begin | 是 | 分组里设备的起始索引值 | 
| count | 是 | 待查询的分组里设备的数量,不能超过1000个 | 
返回说明
正常时的返回JSON数据包示例:
{
  "data": {
      "group_id" : 123,
      "group_name" : "test",
      "total_count": 100,
      "devices" :[
          {
          "device_id" : 123456,
          "uuid" : "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
          "major" : 10001,
        						
相关
视频
RELATED VIDEOS
科技资讯
1
2
3
4
5
6
7
8
9
精选课程
							
							共5课时
17.2万人学习
							
							共49课时
77万人学习
							
							共29课时
61.7万人学习
							
							共25课时
39.3万人学习
							
							共43课时
70.9万人学习
							
							共25课时
61.6万人学习
							
							共22课时
23万人学习
							
							共28课时
33.9万人学习
							
							共89课时
125万人学习