W3Cschool
恭喜您成為首批注冊用戶
獲得88經(jīng)驗值獎勵
通過此接口獲取WiFi的門店列表,該列表包括公眾平臺的門店信息、以及添加設(shè)備后的WiFi相關(guān)信息。創(chuàng)建門店方法請參考“微信門店接口”。
注:微信連Wi-Fi下的所有接口中的shop_id,必需先通過此接口獲取。
接口調(diào)用說明
協(xié)議:https http請求方式: POST 請求URL:https://api.weixin.qq.com/bizwifi/shop/list?access_token=ACCESS_TOKENPOST 數(shù)據(jù)格式:JSON
請求參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | JSON數(shù)據(jù) |
POST數(shù)據(jù)
數(shù)據(jù)示例:
{ "pageindex": 1, "pagesize":2 }
字段說明:
字段 | 是否必填 | 說明 |
---|---|---|
pageindex | 否 | 分頁下標(biāo),默認(rèn)從1開始 |
pagesize | 否 | 每頁的個數(shù),默認(rèn)10個,最大20個 |
返回數(shù)據(jù)說明
正確返回JSON數(shù)據(jù)示例:
{ "errcode": 0, "data": { "totalcount": 16, "pageindex": 1, "pagecount": 8, "records": [ { "shop_id": 429620, "shop_name": "南山店", "ssid": "WX123", "ssid_list": [ "WX123", "WX456" ], "protocol_type": 4, "sid": "" }, { "shop_id": 7921527, "shop_name": "寶安店", "ssid": "", "ssid_list": [], "protocol_type": 0, "sid": "" } ] } }
字段說明:
字段 | 說明 |
---|---|
totalcount | 總數(shù) |
pageindex | 分頁下標(biāo) |
pagecount | 分頁頁數(shù) |
records | 當(dāng)前頁列表數(shù)組 |
shop_id | 門店ID |
shop_name | 門店名稱 |
ssid | 無線網(wǎng)絡(luò)設(shè)備的ssid,未添加設(shè)備為空,多個ssid時顯示第一個 |
ssid_list | 無線網(wǎng)絡(luò)設(shè)備的ssid列表,返回數(shù)組格式 |
protocol_type | 門店內(nèi)設(shè)備的設(shè)備類型,0-未添加設(shè)備,1-專業(yè)型設(shè)備,4-密碼型設(shè)備,5-portal自助型設(shè)備,31-portal改造型設(shè)備 |
sid | 商戶自己的id,與門店poi_id對應(yīng)關(guān)系,建議在添加門店時候建立關(guān)聯(lián)關(guān)系,具體請參考“微信門店接口” |
通過此接口查詢某一門店的詳細(xì)Wi-Fi信息,包括門店內(nèi)的設(shè)備類型、ssid、密碼、設(shè)備數(shù)量、商家主頁URL、頂部常駐入口文案。
接口調(diào)用說明
協(xié)議:https http請求方式: POST 請求URL:https://api.weixin.qq.com/bizwifi/shop/get?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式:JSON
請求參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | JSON數(shù)據(jù) |
POST數(shù)據(jù)
數(shù)據(jù)示例:
{ "shop_id": 429620 }
字段說明:
字段 | 是否必填 | 說明 |
---|---|---|
pageindex | 分頁下標(biāo),默認(rèn)從1開始 | 否 |
pagesize | 每頁的個數(shù),默認(rèn)10個,最大20個 | 否 |
返回數(shù)據(jù)說明
正確返回JSON數(shù)據(jù)示例:
{ "errcode": 0, "data": { "shop_name": "南山店", "ssid": " WX123", "ssid_list": [ "WX123", "WX456" ], "ssid_password_list": [ { "ssid": "WX123", "password": "123456789" }, { "ssid": "WX456", "password": "21332465dge" } ], "password": "123456789", "protocol_type": 4, "ap_count": 2, "template_id": 1, "homepage_url": "http://www.weixin.qq.com/", "bar_type": 1 } }
字段說明:
字段 | 說明 |
---|---|
shop_name | 門店名稱 |
ssid | 無線網(wǎng)絡(luò)設(shè)備的ssid,未添加設(shè)備為空,多個ssid時顯示第一個 |
ssid_list | 無線網(wǎng)絡(luò)設(shè)備的ssid列表,返回數(shù)組格式 |
ssid_password_list | ssid和密碼的列表,數(shù)組格式。當(dāng)為密碼型設(shè)備時,密碼才有值 |
password | 設(shè)備密碼,當(dāng)設(shè)備類型為密碼型時返回 |
protocol_type | 門店內(nèi)設(shè)備的設(shè)備類型,0-未添加設(shè)備,4-密碼型設(shè)備,31-portal型設(shè)備 |
ap_count | 門店內(nèi)設(shè)備總數(shù) |
template_id | 商家主頁模板類型 |
homepage_url | 商家主頁鏈接 |
bar_type | 頂部常駐入口上顯示的文本內(nèi)容:0--歡迎光臨+公眾號名稱;1--歡迎光臨+門店名稱;2--已連接+公眾號名稱+WiFi;3--已連接+門店名稱+Wi-Fi |
finishpage_url | 連網(wǎng)完成頁鏈接 |
通過此接口修改門店的網(wǎng)絡(luò)信息,包括網(wǎng)絡(luò)名稱(ssid)或密碼。需注意:
1. 只有門店下已添加Wi-Fi網(wǎng)絡(luò)信息,才能調(diào)用此接口修改網(wǎng)絡(luò)信息;添加方式請參考“添加密碼型設(shè)備”和“添加portal型設(shè)備”接口文檔。
2. 網(wǎng)絡(luò)信息修改后,密碼型設(shè)備需同步修改所有設(shè)備的ssid或密碼;portal型設(shè)備需修改所有設(shè)備的ssid,并按照《硬件鑒權(quán)協(xié)議接口》修改“第二步:改造移動端portal頁面”中的ssid參數(shù),否則將無法正常連網(wǎng)。
接口調(diào)用說明
協(xié)議:https http請求方式: POST 請求URL: https://api.weixin.qq.com/bizwifi/shop/update?access_token=ACCESS_TOKEN 數(shù)據(jù)格式:JSON
請求參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
POST數(shù)據(jù) | 是 | JSON數(shù)據(jù) |
POST數(shù)據(jù)
數(shù)據(jù)示例:
{ "shop_id": 429620, "old_ssid": "WX123", "ssid": "WX567" }
字段說明:
字段 | 是否必填 | 說明 |
---|---|---|
shop_id | 是 | 門店ID |
old_ssid | 是 | 需要修改的ssid,當(dāng)門店下有多個ssid時,必填 |
ssid | 是 | 無線網(wǎng)絡(luò)設(shè)備的ssid。32個字符以內(nèi);ssid支持中文,但可能因設(shè)備兼容性問題導(dǎo)致顯示亂碼,或無法連接等問題,相關(guān)風(fēng)險自行承擔(dān)!當(dāng)門店下是portal型設(shè)備時,ssid必填;當(dāng)門店下是密碼型設(shè)備時,ssid選填,且ssid和密碼必須有一個以大寫字母“WX”開頭 |
password | 否 | 無線網(wǎng)絡(luò)設(shè)備的密碼。8-24個字符;不能包含中文字符;當(dāng)門店下是密碼型設(shè)備時,才可填寫password,且ssid和密碼必須有一個以大寫字母“WX”開頭 |
返回數(shù)據(jù)說明
正確返回JSON數(shù)據(jù)示例:
{ "errcode": 0, }
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網(wǎng)安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: