WeChat public platform developer documentation
/ Wi-Fi門店管理
Wi-Fi門店管理
獲取Wi-Fi門店列表
通過此接口獲取WiFi的門店列表，該列表包括公眾平臺的門店信息、以及添加設備后的WiFi相關信息。創(chuàng)建門店方法請參考“微信門店接口”。
注：微信連Wi-Fi下的所有接口中的shop_id，必需先通過此接口獲取。
接口調用說明
協(xié)議：https http請求方式: POST 請求URL：https://api.weixin.qq.com/bizwifi/shop/list?access_token=ACCESS_TOKENPOST 數據格式：JSON
請求參數說明
| 參數 | 是否必須 | 說明 |
|---|---|---|
| access_token | 是 | 調用接口憑證 |
| POST數據 | 是 | JSON數據 |
POST數據
數據示例：
{
"pageindex": 1,
"pagesize":2
}字段說明：
| 字段 | 是否必填 | 說明 |
|---|---|---|
| pageindex | 否 | 分頁下標，默認從1開始 |
| pagesize | 否 | 每頁的個數，默認10個，最大20個 |
返回數據說明
正確返回JSON數據示例：
{
"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 | 總數 |
| pageindex | 分頁下標 |
| pagecount | 分頁頁數 |
| records | 當前頁列表數組 |
| shop_id | 門店ID |
| shop_name | 門店名稱 |
| ssid | 無線網絡設備的ssid，未添加設備為空，多個ssid時顯示第一個 |
| ssid_list | 無線網絡設備的ssid列表，返回數組格式 |
| protocol_type | 門店內設備的設備類型，0-未添加設備，1-專業(yè)型設備，4-密碼型設備，5-portal自助型設備，31-portal改造型設備 |
| sid | 商戶自己的id，與門店poi_id對應關系，建議在添加門店時候建立關聯(lián)關系，具體請參考“微信門店接口” |
查詢門店Wi-Fi信息
通過此接口查詢某一門店的詳細Wi-Fi信息，包括門店內的設備類型、ssid、密碼、設備數量、商家主頁URL、頂部常駐入口文案。
接口調用說明
協(xié)議：https http請求方式: POST 請求URL：https://api.weixin.qq.com/bizwifi/shop/get?access_token=ACCESS_TOKEN POST數據格式：JSON
請求參數說明
| 參數 | 是否必須 | 說明 |
|---|---|---|
| access_token | 是 | 調用接口憑證 |
| POST數據 | 是 | JSON數據 |
POST數據
數據示例：
{
"shop_id": 429620
}字段說明：
| 字段 | 是否必填 | 說明 |
|---|---|---|
| pageindex | 分頁下標，默認從1開始 | 否 |
| pagesize | 每頁的個數，默認10個，最大20個 | 否 |
返回數據說明
正確返回JSON數據示例：
{
"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 | 無線網絡設備的ssid，未添加設備為空，多個ssid時顯示第一個 |
| ssid_list | 無線網絡設備的ssid列表，返回數組格式 |
| ssid_password_list | ssid和密碼的列表，數組格式。當為密碼型設備時，密碼才有值 |
| password | 設備密碼，當設備類型為密碼型時返回 |
| protocol_type | 門店內設備的設備類型，0-未添加設備，4-密碼型設備，31-portal型設備 |
| ap_count | 門店內設備總數 |
| template_id | 商家主頁模板類型 |
| homepage_url | 商家主頁鏈接 |
| bar_type | 頂部常駐入口上顯示的文本內容：0--歡迎光臨+公眾號名稱；1--歡迎光臨+門店名稱；2--已連接+公眾號名稱+WiFi；3--已連接+門店名稱+Wi-Fi |
| finishpage_url | 連網完成頁鏈接 |
修改門店網絡信息
通過此接口修改門店的網絡信息，包括網絡名稱（ssid）或密碼。需注意：
1. 只有門店下已添加Wi-Fi網絡信息，才能調用此接口修改網絡信息；添加方式請參考“添加密碼型設備”和“添加portal型設備”接口文檔。
2. 網絡信息修改后，密碼型設備需同步修改所有設備的ssid或密碼；portal型設備需修改所有設備的ssid，并按照《硬件鑒權協(xié)議接口》修改“第二步：改造移動端portal頁面”中的ssid參數，否則將無法正常連網。
接口調用說明
協(xié)議：https http請求方式: POST 請求URL： https://api.weixin.qq.com/bizwifi/shop/update?access_token=ACCESS_TOKEN 數據格式：JSON
請求參數說明
| 參數 | 是否必須 | 說明 |
|---|---|---|
| access_token | 是 | 調用接口憑證 |
| POST數據 | 是 | JSON數據 |
POST數據
數據示例：
{
"shop_id": 429620,
"old_ssid": "WX123",
"ssid": "WX567"
}字段說明：
| 字段 | 是否必填 | 說明 |
|---|---|---|
| shop_id | 是 | 門店ID |
| old_ssid | 是 | 需要修改的ssid，當門店下有多個ssid時，必填 |
| ssid | 是 | 無線網絡設備的ssid。32個字符以內；ssid支持中文，但可能因設備兼容性問題導致顯示亂碼，或無法連接等問題，相關風險自行承擔！當門店下是portal型設備時，ssid必填；當門店下是密碼型設備時，ssid選填，且ssid和密碼必須有一個以大寫字母“WX”開頭 |
| password | 否 | 無線網絡設備的密碼。8-24個字符；不能包含中文字符；當門店下是密碼型設備時，才可填寫password，且ssid和密碼必須有一個以大寫字母“WX”開頭 |
返回數據說明
正確返回JSON數據示例：
{
"errcode": 0,
}