Dokumentasi pembangun platform awam WeChat
/ 管理设备与页面的关联关系
管理设备与页面的关联关系
配置设备与页面的关联关系
接口说明
配置时传入该设备需要关联的页面的id列表（该设备原有的关联关系将被直接清除）；
页面的id列表允许为空，当页面的id列表为空时则会清除该设备的所有关联关系。
配置完成后，在此设备的信号范围内，即可摇出关联的页面信息。
在申请设备ID后，可直接使用接口直接配置页面。
若设备配置多个页面，则随机出现页面信息。一个设备最多可配置30个关联页面。
接口调用说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/bindpage?access_token=ACCESS_TOKENPOST数据格式：json
POST数据例子：
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"page_ids":[12345, 23456, 334567]
}
POST数据例子：
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"page_ids":[12345, 23456, 334567]
}
参数说明
| 参数 | 是否必须 | 说明 |
| access_token | 是 | 调用接口凭证 |
| page_ids | 是 | 待关联的页面列表 |
| device_identifier | 是 | 指定页面的设备ID |
| device_id | 是 | 设备编号，若填了UUID、major、minor，则可不填设备编号，若二者都填，则以设备编号为优先 |
| UUID、major、minor | 是 | UUID、major、minor，三个信息需填写完整，若填了设备编号，则可不填此信息 |
返回说明
正常时的返回JSON数据包示例：
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}
"data": {
},
"errcode": 0,
"errmsg": "success."
}
查询设备与页面的关联关系
接口说明
查询设备与页面的关联关系。提供两种查询方式，可指定页面ID分页查询该页面所关联的所有的设备信息；
也可根据设备ID或完整的UUID、Major、Minor查询该设备所关联的所有页面信息。
接口调用说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/relation/search?access_token=ACCESS_TOKENPOST数据格式：json
POST数据例子：
当查询指定设备所关联的页面时：
{
"type": 1,
"device_identifier": {
"device_id": 10011,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major": 1002,
"minor": 1223
}
}
当查询页面所关联的设备时：
{
"type": 2,
"page_id": 11101,
"begin": 0,
"count": 3
}
POST数据例子：
当查询指定设备所关联的页面时：
{
"type": 1,
"device_identifier": {
"device_id": 10011,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major": 1002,
"minor": 1223
}
}
当查询页面所关联的设备时：
{
"type": 2,
"page_id": 11101,
"begin": 0,
"count": 3
}
参数说明
| 参数 | 是否必须 | 说明 |
| access_token | 是 | 调用接口凭证 |
| type | 是 | 查询方式。1： 查询设备的关联关系；2：查询页面的关联关系 |
| device_identifier | 是 | 指定的设备；当type为1时，此项为必填 |
| device_id | 是 | 设备编号，若填了UUID、major、minor，则可不填设备编号，若二者都填，则以设备编号为优先 |
| UUID、major、minor | 是 | UUID、major、minor，三个信息需填写完整，若填了设备编号，则可不填此信息 |
| page_id | 是 | 指定的页面id；当type为2时，此项为必填 |
| begin | 是 | 关联关系列表的起始索引值；当type为2时，此项为必填 |
| count | 是 | 待查询的关联关系数量，不能超过50个；当type为2时，此项为必填 |
返回说明
正常时的返回JSON数据包示例：
{
"data": {
"relations": [
{
"device_id": 797994,
"major": 10001,
"minor": 10023,
"page_id": 50054,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
},
{
"device_id": 797994,
"major": 10001,
"minor": 10023,
"page_id": 50055,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
}
],
"total_count": 2
},
"errcode": 0,
"errmsg": "success."
}
"data": {
"relations": [
{
"device_id": 797994,
"major": 10001,
"minor": 10023,
"page_id": 50054,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
},
{
"device_id": 797994,
"major": 10001,
"minor": 10023,
"page_id": 50055,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
}
],
"total_count": 2
},
"errcode": 0,
"errmsg": "success."
}
参数说明
| 参数 | 说明 |
| relations | 关联关系列表 |
| device_id | 设备编号 |
| UUID、major、minor | UUID、major、minor |
| page_id | 摇周边页面唯一ID |
| total_count | 设备或页面的关联关系总数 |