微信Wi-Fi門店管理

2019-03-14 11:55 更新

獲取Wi-Fi門店列表

Wi-Fi門店


 通過此接口獲取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)系,具體請參考“微信門店接口

查詢門店Wi-Fi信息

門店Wi-Fi

通過此接口查詢某一門店的詳細(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_listssid和密碼的列表,數(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ò)信息

通過此接口修改門店的網(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,
}



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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號