微信平臺管理設(shè)備與頁面的關(guān)聯(lián)關(guān)系

2018-07-27 10:23 更新

配置設(shè)備與頁面的關(guān)聯(lián)關(guān)系

搖一搖配置設(shè)備與頁面的關(guān)聯(lián)關(guān)系

接口說明 

配置時傳入該設(shè)備需要關(guān)聯(lián)的頁面的id列表（該設(shè)備原有的關(guān)聯(lián)關(guān)系將被直接清除）；

頁面的id列表允許為空，當(dāng)頁面的id列表為空時則會清除該設(shè)備的所有關(guān)聯(lián)關(guān)系。

配置完成后，在此設(shè)備的信號范圍內(nèi)，即可搖出關(guān)聯(lián)的頁面信息。

在申請?jiān)O(shè)備ID后，可直接使用接口直接配置頁面。

若設(shè)備配置多個頁面，則隨機(jī)出現(xiàn)頁面信息。一個設(shè)備最多可配置30個關(guān)聯(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]
}

參數(shù)說明

參數(shù)是否必須說明
access_token是調(diào)用接口憑證
page_ids是待關(guān)聯(lián)的頁面列表
device_identifier是指定頁面的設(shè)備ID
device_id是設(shè)備編號，若填了UUID、major、minor，則可不填設(shè)備編號，若二者都填，則以設(shè)備編號為優(yōu)先
UUID、major、minor是UUID、major、minor，三個信息需填寫完整，若填了設(shè)備編號，則可不填此信息  

返回說明 

正常時的返回JSON數(shù)據(jù)包示例：

{
  "data": {
      
  },
  "errcode": 0,
  "errmsg": "success."
}

查詢設(shè)備與頁面的關(guān)聯(lián)關(guān)系

接口說明

查詢設(shè)備與頁面的關(guān)聯(lián)關(guān)系。提供兩種查詢方式，可指定頁面ID分頁查詢該頁面所關(guān)聯(lián)的所有的設(shè)備信息；

也可根據(jù)設(shè)備ID或完整的UUID、Major、Minor查詢該設(shè)備所關(guān)聯(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ù)例子：
當(dāng)查詢指定設(shè)備所關(guān)聯(lián)的頁面時：
{    
  "type": 1,
  "device_identifier": {
      "device_id": 10011,
      "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
      "major": 1002,
      "minor": 1223
  }
}
當(dāng)查詢頁面所關(guān)聯(lián)的設(shè)備時：
{
  "type": 2,
  "page_id": 11101,
  "begin": 0,
  "count": 3
}

參數(shù)說明

參數(shù)是否必須說明
access_token是調(diào)用接口憑證
type是查詢方式。1： 查詢設(shè)備的關(guān)聯(lián)關(guān)系；2：查詢頁面的關(guān)聯(lián)關(guān)系
device_identifier是指定的設(shè)備；當(dāng)type為1時，此項(xiàng)為必填
device_id是設(shè)備編號，若填了UUID、major、minor，則可不填設(shè)備編號，若二者都填，則以設(shè)備編號為優(yōu)先
UUID、major、minor是UUID、major、minor，三個信息需填寫完整，若填了設(shè)備編號，則可不填此信息
page_id是指定的頁面id；當(dāng)type為2時，此項(xiàng)為必填
begin是關(guān)聯(lián)關(guān)系列表的起始索引值；當(dāng)type為2時，此項(xiàng)為必填
count是待查詢的關(guān)聯(lián)關(guān)系數(shù)量，不能超過50個；當(dāng)type為2時，此項(xiàng)為必填   

返回說明

正常時的返回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."
}

參數(shù)說明

參數(shù)說明
relations關(guān)聯(lián)關(guān)系列表
device_id設(shè)備編號
UUID、major、minorUUID、major、minor
page_id搖周邊頁面唯一ID
total_count設(shè)備或頁面的關(guān)聯(lián)關(guān)系總數(shù)

以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號