Wi-Fi門市管理


取得Wi-Fi門市清單

1475892709811631.jpg



# 透過此介面取得WiFi的門市列表，該列表包括公眾平台的門市資訊、以及添加設備後的WiFi相關資訊。建立門市方法請參考「微信門店介面」##。

  注意：微信連Wi-Fi下的所有介面中的shop_id，必要先透過此介面取得。

介面呼叫說明

协议：https
http请求方式: POST
请求URL：https://api.weixin.qq.com/bizwifi/shop/list?access_token=ACCESS_TOKENPOST
数据格式：JSON

請求參數說明

##

POST資料

資料範例：

{
  "pageindex": 1,		
  "pagesize":2
}

欄位說明：

參數是否必須說明
access_token是呼叫介面憑證
POST資料是JSON資料
欄位是否必填說明
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": ""
      }
    ]
  }
}

欄位說明：

totalcountpageindexpagecountrecordsshop_idshop_namessid ssid_list#protocol_type
欄位說明
#totalcount
分頁下標
#分頁頁數
目前頁清單陣列
門店ID
門市名稱
無線網路裝置的ssid，未新增裝置為空，多個ssid時顯示第一個
無線網路設備的ssid列表，返回數組格式
門店內設備的設備類型，0-未添加設備，1 -專業型設備，4-密碼型設備，5-portal自助型設備，31-portal改造型設備############sid######商家自己的id，與門市poi_id對應關係，建議在新增門市時建立關聯關係，具體請參考「微信門店介面」############

查詢門市Wi-Fi資訊

201610081039168575.png

透過此介面查詢某一門市的詳細Wi-Fi信息，包括門店內的設備類型、ssid、密碼、設備數量、商家主頁URL、頂部常駐入口文案。

介面呼叫說明

协议：https
http请求方式: POST
请求URL：https://api.weixin.qq.com/bizwifi/shop/get?access_token=ACCESS_TOKEN
POST数据格式：JSON

請求參數說明

JSON資料
參數 是否必須說明
access_token是呼叫介面憑證
##POST資料是
#######

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_listssid和密碼的列表，陣列格式。當為密碼型設備時，密碼才有值
password裝置密碼，當裝置類型為密碼型時傳回
#protocol_type

門店內設備的設備類型，0-未新增設備，4-密碼型設備，31-portal型設備

ap_count門店內裝置總數
#template_id
##homepage_url商家主頁連結
#bar_type頂部常駐入口上顯示的文字內容：0--歡迎光臨公眾號名稱；1--歡迎光臨門市名稱；2--已連接公眾號名稱WiFi；3--已連接門市名稱Wi-Fi
finishpage_url
### ###連網完成頁連結############

修改門市網路資訊

#

201610081039383742.jpg

透過此介面修改門市的網路訊息，包括網路名稱（ssid）或密碼。需注意：

1. 只有門市下方已新增Wi-Fi網路訊息，才能呼叫此介面修改網路資訊；新增方式請參考「新增密碼型裝置」和“新增portal型設備”介面文件。

2. 網路資訊修改後，密碼型設備需同步修改所有設備的ssid或密碼；portal型設備需修改所有設備的ssid，並依照《硬體鑑權協定接口》修改「第二步：改造行動端portal頁面」中的ssid參數，否則將無法正常連網。

介面呼叫說明

协议：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,
}



##
←
→