管理設備與頁面的關聯關係


設定設備與頁面的關聯關係

1475204329604291.png

介面說明 

設定時傳入該裝置需要關聯的頁面的id清單（該裝置原有的關聯關係將直接清除）；

頁的id清單允許為空，當頁面的id清單為空時則會清除該裝置的所有關聯關係。

配置完成後，在此裝置的訊號範圍內，即可搖出關聯的頁面資訊。

在申請設備ID後，可直接使用介面直接設定頁面。

若裝置配置多個頁面，則隨機出現頁面資訊。一個設備最多可配置30個關聯頁面。

介面呼叫說明

#http要求方式:POST（請使用https協定）https://api. weixin.qq.com/shakearound/device/bindpage?access_token=ACCESS_TOKENPOST資料格式：json
POST資料範例：
{
   "device_identifier":{
  101  "uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
              "major":1002,##      "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."
}

##################################################################################### ############查詢裝置與頁面的關聯關係#######

介面說明

#查詢裝置與頁面的關聯關係。提供兩種查詢方式，可指定頁面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-C6EBuuid": "FDA50693-A4E2-4FB1-AFCF-C6EBuuid": "FDA50693-A4E2-4FB1-AFCF-C6EBuuid": "FDA50693-A4E2-4FB1-AFCF-C6EBuuid": "FDA50693-A4E2-4FB1-AFCF-C6EBuuid": "FDA50693-A4E2-4FB1-AFCF-C6EBuuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825 "minor": 1223
  }
}
當查詢頁面所關聯的裝置：
{
  "type": 2,
  "page_id": 11101,
"begin": 0,
  "count": 3
}

參數說明

##UUID、major、 minor，三個資訊需填寫完整，若填了設備編號，則可不填此資訊##page_id#是關聯關係清單的起始索引值；當type為2時，此項目為必填count是#待查詢的關聯關係數量，不能超過50個；當type為2時，此項目為必填  
參數是否必須##說明
access_token是
#呼叫介面憑證########################################### ########type############是###查詢方式。1：查詢裝置的關聯關係；2：查詢頁面的關聯關係
#device_identifier##是 #指定的裝置；當type為1時，此項目為必填
device_id是設備編號，若填了UUID、major、minor，則可不填設備編號，若二者都填，則以設備編號為優先
UUID、major、minor#是
###################### #是####指定的頁面id；當type為2時，此項目為必填
begin
######

傳回說明

正常時的回傳JSON封包範例：

##{  "data": {
      "relations": [
          {
              "device_id": 797994,10102#             "minor": 10023,
              "page_id ": 50054,
              "uuid": "             "uuid": "             "uuid": "     "device_id": 797994,
              "major": 10001,
              "minor": 10023,
              "page_id": 50055,
 47825"
          }
      ],
      "total_count" : 2
  },
  "errcode": 0,
  "errmsg": "success."
}

參數說明

參數說明
relations關聯關係清單
#device_id裝置編號
UUID、major、minor#UUID、major、minor
page_id搖搖週邊頁面唯一ID


total_count############裝置或頁面的關聯關係總數############################# #######
←
→