W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
調(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è)備
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è)備添加成功。
調(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。
可通過(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è)備 |
根據(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 }
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: