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