html5頁面取得設備信息


新增分組

1475889489342022.png

#介面說明

新設備分組，每個帳號下最多只有1000個分組。

介面呼叫說明

#http要求方式:POST（請使用https協定）https:/ /api.weixin.qq.com/shakearound/device/group/add?access_token=ACCESS_TOKENPOST資料格式：json
POST資料範例：
{
  "group_name":"test"
}

參數說明

參數是否必須##說明
access_token是
#呼叫介面憑證########################################### ########group_name############是###分組名稱，不超過100漢字或200個英文字母   


傳回說明

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

#{
  "data": {
      "group_id" : 123,
      "group_name" : "test"
  },
  "errcode": 00 ,
  "errmsg": "success."
}

#

參數說明

参数说明
group_id 分组唯一标识，全局唯一
group_name分组名 

編輯分組資訊

介面說明

#編輯設備分組訊息，目前只能修改分組名。

介面呼叫說明

#http要求方式:POST（請使用https協定）https:/ /api.weixin.qq.com/shakearound/device/group/update?access_token=ACCESS_TOKENPOST資料格式：json
POST資料範例：
{
  "group_id":123,
  "group_name" :"test update"
}

#

參數說明

參數是否必須##說明
access_token是
#呼叫介面憑證########################################### ########group_id############是###分組唯一標識，全域唯一
#group_name是 分組名稱，不超過100漢字或200個英文字母
#


傳回說明

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

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


#刪除分組

##########################################################################

介面說明

#刪除設備分組，若分組中仍有設備，則不能刪除成功。需把設備移除以後，才能刪除。

介面呼叫說明

#http要求方式:POST（請使用https協定）https:/ /api.weixin.qq.com/shakearound/device/group/delete?access_token=ACCESS_TOKENPOST資料格式：json
POST資料範例：
{
  "group_id":123
}

#

參數說明

參數是否必須##說明
access_token是
#呼叫介面憑證########################################### ########group_id############是###分組唯一標識，全域唯一   
#


傳回說明

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

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


#查詢分組清單

介面說明

#查詢帳號下所有的分組。

介面呼叫說明

#http要求方式:POST（請使用https協定）https:/ /api.weixin.qq.com/shakearound/device/group/getlist?    access_token=ACCESS_TOKEN
POST資料格式：json
POST資料範例：
{
  "begin": 0,
  "count" 10
}

#

參數說明

#


傳回說明

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

#{
  "data": {
  "total_count": 100,
      "groups":[
       {
   group, ##o  13" #          "group_name" : "test1"
      },
      {
          "group_約##     ]
  },
  "errcode": 0,
  "errmsg": "success."
}



參數說明

參數是否必須##說明
access_token是
#呼叫介面憑證########################################### ########begin############是###分組清單的起始索引值
#count##是要待查詢的分組數量，不能超過1000個 
參數說明 
total_count是#此帳號下現有的總分組數
groups是###########################
group_id是分組唯一標識，全域唯一
group_name是
############################################################################################################################################################################################################################################。 ########

查詢分組詳情

#介面說明

查詢分組詳情，包含分組名，分組id，分組裡的設備清單。

介面呼叫說明

#http要求方式:POST（請使用https協定）https:/ /api.weixin.qq.com/shakearound/device/group/getdetail?access_token=ACCESS_TOKENPOST資料格式：json
POST資料範例：
{
  "group_id":123
  "begin": 0,
  "count":100
}

#

參數說明

參數是否必須##說明
access_token是
#呼叫介面憑證########################################### ########group_id############是###分組唯一標識，全域唯一
#begin是 分組裡裝置的起始索引值
#count是待查詢的分組裡裝置的數量，不能超過1000個   


傳回說明

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

#{
  "data": {
      "group_id" : 123,
      "group_name" : "test",
     "total_count":# 100, "test",
     "total_count":## "devices" :[
          {
          "device_id" : 123456,
          "uuid" : "FDA50699        "major" : 10001,
          " minor" : 10001,
          "comment" : "test device1",
          "poi_id" ：      "device_id" : 123457,
          "uuid" : "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
          "major" : 10001,
   device2",
          "poi_id" : 12345,
          }
          ]
      },
#  "errcode": 0,
  "errmsg": "success.##}#ocess.

參數說明

參數說明
group_id分組唯一標識，全域唯一
#group_name分組名稱
total_count#此分組現有的總裝置數
devices分組下的裝置清單
device_id裝置編號，裝置全域唯一ID
#uuid, major, minor#uuid, major, minor
#comment裝置的備註資訊
#poi_id裝置關聯的門市ID，關聯門市後，在門市1KM的範圍內有優先搖出資訊的機會。門市相關資訊可具體可檢視門市相關的介面文件    

##############################################

新增裝置到分組

#介面說明

#新增設備到分組，每個分組能夠持有的設備上限為10000，且每次新增操作的新增上限為1000。只有在搖週邊申請的設備才能加入到分組。

介面呼叫說明

#http要求方式:POST（請使用https協定）https:/ /api.weixin.qq.com/shakearound/device/group/adddevice?access_token=ACCESS_TOKENPOST資料格式：json
POST資料範例：
{
  "group_id": 123,
(device_identifiers" :[
          {
          "device_id":10100,
          "uuid":  693-A4E2-41-A4E2-41-7 major":10001,
          "minor": 10002
          }
          ]
}

參數說明

參數是否必須##說明
access_token是
#呼叫介面憑證########################################### ########device_identifiers############是###裝置id清單
#device_id是device_id
是 裝置編號，若填了UUID、major、minor，即可不填裝置編號，二者選其一UUID、major 、minor
是UUID、major、minor，三個資訊需填寫完成，若填了設備編號，即可不填此訊息，二者選其一group_id
############################################################################# #分組唯一標識，全域唯一################

傳回說明

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

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


##從分組移除裝置

介面說明

#從分組移除設備，每次刪除操作的上限為1000。

介面呼叫說明

#http要求方式:POST（請使用https協定）https:/ /api.weixin.qq.com/shakearound/device/group/deletedevice?access_token=ACCESS_TOKENPOST資料格式：json
POST資料範例：
{
 "group_id": 123,
  "device_identifiers" :[
          {
          "device_id":10100,
          "uuid": major":10001,
          "minor": 10002
          }
          ]
}

##############################################################################################

參數說明

參數是否必須##說明
access_token是
#呼叫介面憑證########################################### ########device_identifiers############是###裝置id清單
#device_id是device_id
是 裝置編號，若填了UUID、major、minor，即可不填裝置編號，二者選其一UUID、major 、minor
是UUID、major、minor，三個資訊需填寫完成，若填了設備編號，即可不填此訊息，二者選其一group_id
############################################################ #分組唯一標識，全域唯一 ################


傳回說明

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

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


#H5頁面取得裝置資訊JS API

目錄

#1 #開啟尋找周邊ibeacon裝置介面

2 關閉尋找週邊ibeacon裝置介面

3 監聽週邊ibeacon裝置介面

 

介面說明

H5頁面取得裝置資訊JS API是為了擴充搖週邊應用的場景，讓開發者在自己的H5應用程式上透過接入微信JS-SDK，實現搜尋週邊Beacon訊號的一套api。在呼叫此介面之前，需要先把設備分組，微信客戶端只會返回已在分組中的設備信息，如何把設備分組，請查看上述分組相關的接口描述。

#

H5頁面取得裝置資訊JSAPI包括startSearchBeacons、stopSearchBeacons、onSearchBeacons三個接口，只支援6.2.5以上的微信版本調用，需使用微信JS-SDK調用，且調用調用的公眾帳號需與建立分組的公眾帳號一致。在需要調用JS介面的頁面引入如下JS文件，（支援https）：http://res.wx.qq.com/open/js/jweixin-1.1.0.js，查看具體JS-SDK調用方法。

開啟尋找周邊ibeacon裝置介面

介面說明

查找週邊設備，目的是為有一定開發能力的商家提供查找自己週邊設備的接口，在微信內建瀏覽器中被訪問的網頁，可使用該JS代碼調起查找商家自己週邊的設備，方便商家利用此介面檢查週邊是否有自己的設備。微信客戶端只要偵測到有訊號的裝置即回傳設備訊息，時間間隔為1S，android與iOS皆批量返回偵測到有訊息的裝置。

介面呼叫說明

#

範例：
wx.startSearchBeacons({
  ticket:"",
  complete:function(argv){
  //回呼函數
  }
});

#

參數說明

參數是否必須##說明
ticket否
搖週邊的業務ticket，系統自動加入搖出來的頁面連結後面          ################

返回說明

開啟成功返回：「startSearchBeacons:ok」;

開啟後未stop再次開啟：「startSearchBeacons:already started」；

藍牙未開啟返回：「startSearchBeacons:bluetooth power off」；

地理位置服務未開啟回傳：「startSearchBeacons:location service disable」;

系統不支援回傳：「startSearchBeacons:system unsupported」。

關閉尋找周邊ibeacon裝置介面

介面說明

關閉尋找週邊裝置。

介面呼叫說明

#範例：
wx.stopSearchBeacons({
  complete :function(res){
  //回呼函數
  }
});

返回說明

關閉成功返回「stopSearchBeacons:ok」;

##監聽週邊ibeacon裝置介面

介面說明

監聽週邊裝置onSearchBeacons介面是在startSearchBeacons介面開啟後回調的，該介面會傳回該商家註冊的在周邊的相關設備。

介面呼叫說明

#範例：wx.onSearchBeacons({
  complete :function(argv){
  //回呼函數
  }
});

##返回說明

onSearchBeacons:{
#  "beacons":[
          {
“主要”：10008，
          “次要”：57686，
          “uuid”：“FDA50693-A4E2-4FB1-AFCF-C6EB07647825”，
          “準確度”：“0.235344”，
「rs斯":"-66",
          「鄰近度」:「1」,
          「標題」:「288.1355」##  ”:10008,
          "次要":57687,
          “uuid”:“FDA50693-A4E2-4FB1-AFCF-C6EB07647825”, #109#        “rssi”:“- 49”,
“接近”：“2”，
          “標題”：“288.1355”
          }
     #   ]
# 

參數說明

參數說明
#UUID、major 、minorUUID、major、minor
accuracy
######################################################################距離，單位為米##################proximity############精度，0：CLProximityUnknown, 1：CLProximityImmediate, 2：CLProximityNear, 3：CLProximityFar###
rssi接收訊號的強度指示
heading接收訊號時裝置的方向（安卓裝置傳回有此字段，iOS無）；iOS裝置若需要取得方向，可以利用HTML5標準API獲取，查看範例



#########
←
→