微信Wi-Fi設(shè)備管理

2019-03-14 11:57 更新

添加密碼型設(shè)備

Wi-Fi設(shè)備管理

調(diào)用此接口向指定門店添加密碼型設(shè)備的Wi-Fi信息。為保證門店下多臺(tái)設(shè)備無(wú)縫漫游。

1. 同一個(gè)門店可以添加多個(gè)ssid,最大添加100個(gè)ssid;

2. 已添加過(guò)的ssid不能再重復(fù)添加;

3. 一個(gè)門店只能擁有一種設(shè)備類型,只要調(diào)用此接口添加一個(gè)ssid后,該門店即為密碼型設(shè)備,不能再添加portal型設(shè)備。調(diào)用清空門店Wi-Fi信息接口清空網(wǎng)絡(luò)信息后,可再設(shè)置為其它類型設(shè)備。


注意: 調(diào)用此接口后需要進(jìn)行以下兩步操作,才能正式啟用設(shè)備

  1. 進(jìn)入無(wú)線路由器的管理后臺(tái),修改待添加設(shè)備的ssid和密碼,保證設(shè)備的ssid和密碼與調(diào)用接口時(shí)填寫的一致

2. 請(qǐng)務(wù)必調(diào)用“獲取物料二維碼”接口,下載該門店二維碼,張貼于店內(nèi)。并確保有人(顧客或店員)用6.1以上安卓版微信或6.2.2以上IOS版微信掃碼連接Wi-Fi,連網(wǎng)成功即表示設(shè)備添加成功。


接口調(diào)用說(shuō)明

協(xié)議:https
http請(qǐng)求方式: POST
請(qǐng)求URL:https://api.weixin.qq.com/bizwifi/device/add?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式:JSON

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token調(diào)用接口憑證
POST數(shù)據(jù)JSON數(shù)據(jù)

POST數(shù)據(jù)

數(shù)據(jù)示例:

{
  "shop_id": 429620,
  "ssid": "WX123",
  "password": "12345689",
}

字段說(shuō)明:

字段是否必填說(shuō)明
shop_id門店ID
ssid無(wú)線網(wǎng)絡(luò)設(shè)備的ssid。ssid和密碼必須有一個(gè)以大寫字母“WX”開頭;32個(gè)字符以內(nèi);ssid支持中文,但可能因設(shè)備兼容性問(wèn)題導(dǎo)致顯示亂碼,或無(wú)法連接等問(wèn)題,相關(guān)風(fēng)險(xiǎn)自行承擔(dān)!
password無(wú)線網(wǎng)絡(luò)設(shè)備的密碼。8-24個(gè)字符;不能包含中文字符;ssid和密碼必須有一個(gè)以大寫字母“WX”開頭

返回?cái)?shù)據(jù)說(shuō)明 

正確返回JSON數(shù)據(jù)示例:

{
  "errcode": 0
}


注意:添加設(shè)備完成后,請(qǐng)務(wù)必調(diào)用“獲取物料二維碼”接口,下載該門店二維碼,張貼于店內(nèi)。并確保有人(顧客或店員)用6.1以上安卓版微信或6.2.2以上IOS版微信掃碼連接Wi-Fi,連網(wǎng)成功即表示設(shè)備添加成功。

添加portal型設(shè)備

調(diào)用下述接口可以添加portal型設(shè)備的網(wǎng)絡(luò)信息,并獲得secretkey。secretkey為加密字符串參數(shù),是portal設(shè)備改造流程中的重要參數(shù)。為防止secretkey泄露,可通過(guò)此接口重置刷新,重置后之前生成的secretkey將會(huì)失效。需注意

1. 同一個(gè)門店可以添加多個(gè)ssid,最大添加100個(gè)ssid;

2. 一個(gè)門店只能擁有一種設(shè)備類型,只要調(diào)用此接口添加一個(gè)ssid后,該門店即為portal型改造設(shè)備。如果門店下已有非portal型設(shè)備時(shí),無(wú)法調(diào)用此接口。

接口調(diào)用說(shuō)明

協(xié)議:https
http請(qǐng)求方式: POST
請(qǐng)求URL:https://api.weixin.qq.com/bizwifi/apportal/register?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式:JSON

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token調(diào)用接口憑證
POST數(shù)據(jù)JSON數(shù)據(jù)

POST數(shù)據(jù)

數(shù)據(jù)示例:

{
   "shop_id": 429620,
   "ssid": "WX123",
   "reset": false
}

字段說(shuō)明:

字段是否必填說(shuō)明
shop_id門店ID
ssid無(wú)線網(wǎng)絡(luò)設(shè)備的ssid,限30個(gè)字符以內(nèi)。ssid支持中文,但可能因設(shè)備兼容性問(wèn)題導(dǎo)致顯示亂碼,或無(wú)法連接等問(wèn)題,相關(guān)風(fēng)險(xiǎn)自行承擔(dān)!
reset重置secretkey,false-不重置,true-重置,默認(rèn)為false

返回?cái)?shù)據(jù)說(shuō)明 

正確返回JSON數(shù)據(jù)示例:

{
   "errcode": 0,
   "data": {
     "secretkey": "1af08ec5cdb70a4d7365bcd64d3120f6"
   }
}

字段說(shuō)明:


字段說(shuō)明
secretkey改造portal頁(yè)面所需參數(shù),該參數(shù)用于觸發(fā)呼起微信的JSAPI接口的sign參數(shù)值的計(jì)算



   注意:

  添加設(shè)備完成后,務(wù)必按照鑒權(quán)協(xié)議接口進(jìn)行設(shè)備改造,否則無(wú)法實(shí)現(xiàn)微信連Wi-Fi。

查詢?cè)O(shè)備


可通過(guò)指定分頁(yè)或具體門店ID的方式,查詢當(dāng)前MP賬號(hào)下指定門店連網(wǎng)成功的設(shè)備信息。一次最多能查詢20個(gè)門店的設(shè)備信息。

接口調(diào)用說(shuō)明

協(xié)議:https
http請(qǐng)求方式: POST
請(qǐng)求URL:https://api.weixin.qq.com/bizwifi/device/list?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式:JSON

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token調(diào)用接口憑證
POST數(shù)據(jù)JSON數(shù)據(jù)

POST數(shù)據(jù)

數(shù)據(jù)示例:

分頁(yè)查詢時(shí):
{
   "pageindex": 1,		
   "pagesize":10
}
根據(jù)門店ID查詢時(shí):
{
   "pageindex": 1,		
   "pagesize":10,
   "shop_id":429620
}

字段說(shuō)明:

字段是否必填說(shuō)明
pageindex分頁(yè)下標(biāo),默認(rèn)從1開始
pagesize每頁(yè)的個(gè)數(shù),默認(rèn)10個(gè),最大20個(gè)
shop_id根據(jù)門店id查詢

返回?cái)?shù)據(jù)說(shuō)明 

正確返回JSON數(shù)據(jù)示例:

{
   "errcode": 0,
   "data": {
     "totalcount": 2,
     "pageindex": 1,
     "pagecount": 1,
     "records": [
       {
         "shop_id": 429620,
         "ssid": "WX123",
         "bssid": "00:1f:7a:ad:5b:a9",
         "protocol_type":4
       },
       {
         "shop_id": 429620,
         "ssid": "WX123",
         "bssid": "00:1f:7a:ad:5c:a8",
         "protocol_type":4
       }
     ]
   }
}

字段說(shuō)明:

字段說(shuō)明
totalcount總數(shù)
pageindex分頁(yè)下標(biāo)
pagecount分頁(yè)頁(yè)數(shù)
records當(dāng)前頁(yè)列表數(shù)組
shop_id門店ID
ssid連網(wǎng)設(shè)備ssid
bssid無(wú)線MAC地址
protocol_type門店內(nèi)設(shè)備的設(shè)備類型,0-未添加設(shè)備,4-密碼型設(shè)備,31-portal型設(shè)備

刪除設(shè)備

根據(jù)bssid刪除門店下的單個(gè)設(shè)備。刪除后請(qǐng)盡快修改設(shè)備的網(wǎng)絡(luò)名稱和密碼,或停止使用設(shè)備,否則設(shè)備會(huì)自動(dòng)重新添加進(jìn)來(lái)。如需清空門店網(wǎng)絡(luò)及所有設(shè)備,請(qǐng)調(diào)用“清空門店網(wǎng)絡(luò)及設(shè)備”接口。

接口調(diào)用說(shuō)明

協(xié)議:https
http請(qǐng)求方式: POST
請(qǐng)求URL:https://api.weixin.qq.com/bizwifi/device/delete?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式:JSON

請(qǐng)求參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明
access_token調(diào)用接口憑證
POST數(shù)據(jù)JSON數(shù)據(jù)

POST數(shù)據(jù)

數(shù)據(jù)示例:

{
  "bssid":"00:1f:7a:ad:5c:a8"
}

字段說(shuō)明:

字段是否必填說(shuō)明
bssid需要?jiǎng)h除的無(wú)線網(wǎng)絡(luò)設(shè)備無(wú)線mac地址,格式冒號(hào)分隔,字符長(zhǎng)度17個(gè),并且字母小寫,例如:00:1f:7a:ad:5c:a8

返回?cái)?shù)據(jù)說(shuō)明 

正確返回JSON數(shù)據(jù)示例:

{
   "errcode": 0
}




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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)