Dokumentasi pembangun platform awam WeChat
/ 管理設備與頁面的關聯(lián)關系
管理設備與頁面的關聯(lián)關系
配置設備與頁面的關聯(lián)關系
接口說明
配置時傳入該設備需要關聯(lián)的頁面的id列表（該設備原有的關聯(lián)關系將被直接清除）；
頁面的id列表允許為空，當頁面的id列表為空時則會清除該設備的所有關聯(lián)關系。
配置完成后，在此設備的信號范圍內(nèi)，即可搖出關聯(lián)的頁面信息。
在申請設備ID后，可直接使用接口直接配置頁面。
若設備配置多個頁面，則隨機出現(xiàn)頁面信息。一個設備最多可配置30個關聯(lián)頁面。
接口調(diào)用說明
http請求方式: POST（請使用https協(xié)議）https://api.weixin.qq.com/shakearound/device/bindpage?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式：json
POST數(shù)據(jù)例子：
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"page_ids":[12345, 23456, 334567]
}
POST數(shù)據(jù)例子：
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"page_ids":[12345, 23456, 334567]
}
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| access_token | 是 | 調(diào)用接口憑證 |
| page_ids | 是 | 待關聯(lián)的頁面列表 |
| device_identifier | 是 | 指定頁面的設備ID |
| device_id | 是 | 設備編號，若填了UUID、major、minor，則可不填設備編號，若二者都填，則以設備編號為優(yōu)先 |
| UUID、major、minor | 是 | UUID、major、minor，三個信息需填寫完整，若填了設備編號，則可不填此信息 |
返回說明
正常時的返回JSON數(shù)據(jù)包示例：
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}
"data": {
},
"errcode": 0,
"errmsg": "success."
}
查詢設備與頁面的關聯(lián)關系
接口說明
查詢設備與頁面的關聯(lián)關系。提供兩種查詢方式，可指定頁面ID分頁查詢該頁面所關聯(lián)的所有的設備信息；
也可根據(jù)設備ID或完整的UUID、Major、Minor查詢該設備所關聯(lián)的所有頁面信息。
接口調(diào)用說明
http請求方式: POST（請使用https協(xié)議）https://api.weixin.qq.com/shakearound/relation/search?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式：json
POST數(shù)據(jù)例子：
當查詢指定設備所關聯(lián)的頁面時：
{
"type": 1,
"device_identifier": {
"device_id": 10011,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major": 1002,
"minor": 1223
}
}
當查詢頁面所關聯(lián)的設備時：
{
"type": 2,
"page_id": 11101,
"begin": 0,
"count": 3
}
POST數(shù)據(jù)例子：
當查詢指定設備所關聯(lián)的頁面時：
{
"type": 1,
"device_identifier": {
"device_id": 10011,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major": 1002,
"minor": 1223
}
}
當查詢頁面所關聯(lián)的設備時：
{
"type": 2,
"page_id": 11101,
"begin": 0,
"count": 3
}
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| access_token | 是 | 調(diào)用接口憑證 |
| type | 是 | 查詢方式。1： 查詢設備的關聯(lián)關系；2：查詢頁面的關聯(lián)關系 |
| device_identifier | 是 | 指定的設備；當type為1時，此項為必填 |
| device_id | 是 | 設備編號，若填了UUID、major、minor，則可不填設備編號，若二者都填，則以設備編號為優(yōu)先 |
| UUID、major、minor | 是 | UUID、major、minor，三個信息需填寫完整，若填了設備編號，則可不填此信息 |
| page_id | 是 | 指定的頁面id；當type為2時，此項為必填 |
| begin | 是 | 關聯(lián)關系列表的起始索引值；當type為2時，此項為必填 |
| count | 是 | 待查詢的關聯(lián)關系數(shù)量，不能超過50個；當type為2時，此項為必填 |
返回說明
正常時的返回JSON數(shù)據(jù)包示例：
{
"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."
}
參數(shù)說明
| 參數(shù) | 說明 |
| relations | 關聯(lián)關系列表 |
| device_id | 設備編號 |
| UUID、major、minor | UUID、major、minor |
| page_id | 搖周邊頁面唯一ID |
| total_count | 設備或頁面的關聯(lián)關系總數(shù) |