閱讀(8.9k) 書簽贊(0) 我要糾錯(cuò)

微信Wi-Fi門店管理

2019-03-14 11:55 更新

獲取Wi-Fi門店列表

通過此接口獲取WiFi的門店列表，該列表包括公眾平臺(tái)的門店信息、以及添加設(shè)備后的WiFi相關(guān)信息。創(chuàng)建門店方法請(qǐng)參考“微信門店接口”。

注：微信連Wi-Fi下的所有接口中的shop_id，必需先通過此接口獲取。

接口調(diào)用說明

協(xié)議：https
http請(qǐng)求方式: POST
請(qǐng)求URL：https://api.weixin.qq.com/bizwifi/shop/list?access_token=ACCESS_TOKENPOST
數(shù)據(jù)格式：JSON

請(qǐng)求參數(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	否	每頁的個(gè)數(shù)，默認(rèn)10個(gè)，最大20個(gè)

返回?cái)?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è)備為空，多個(gè)ssid時(shí)顯示第一個(gè)
ssid_list	無線網(wǎng)絡(luò)設(shè)備的ssid列表，返回?cái)?shù)組格式
protocol_type	門店內(nèi)設(shè)備的設(shè)備類型，0-未添加設(shè)備，1-專業(yè)型設(shè)備，4-密碼型設(shè)備，5-portal自助型設(shè)備，31-portal改造型設(shè)備
sid	商戶自己的id，與門店poi_id對(duì)應(yīng)關(guān)系，建議在添加門店時(shí)候建立關(guān)聯(lián)關(guān)系，具體請(qǐng)參考“微信門店接口”

查詢門店Wi-Fi信息

門店Wi-Fi

通過此接口查詢某一門店的詳細(xì)Wi-Fi信息，包括門店內(nèi)的設(shè)備類型、ssid、密碼、設(shè)備數(shù)量、商家主頁URL、頂部常駐入口文案。

接口調(diào)用說明

協(xié)議：https
http請(qǐng)求方式: POST
請(qǐng)求URL：https://api.weixin.qq.com/bizwifi/shop/get?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式：JSON

請(qǐng)求參數(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	每頁的個(gè)數(shù)，默認(rèn)10個(gè)，最大20個(gè)	否

返回?cái)?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è)備為空，多個(gè)ssid時(shí)顯示第一個(gè)
ssid_list	無線網(wǎng)絡(luò)設(shè)備的ssid列表，返回?cái)?shù)組格式
ssid_password_list	ssid和密碼的列表，數(shù)組格式。當(dāng)為密碼型設(shè)備時(shí)，密碼才有值
password	設(shè)備密碼，當(dāng)設(shè)備類型為密碼型時(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--歡迎光臨+公眾號(hào)名稱；1--歡迎光臨+門店名稱；2--已連接+公眾號(hào)名稱+WiFi；3--已連接+門店名稱+Wi-Fi
finishpage_url	連網(wǎng)完成頁鏈接

修改門店網(wǎng)絡(luò)信息

通過此接口修改門店的網(wǎng)絡(luò)信息，包括網(wǎng)絡(luò)名稱（ssid）或密碼。需注意：

1. 只有門店下已添加Wi-Fi網(wǎng)絡(luò)信息，才能調(diào)用此接口修改網(wǎng)絡(luò)信息；添加方式請(qǐng)參考“添加密碼型設(shè)備”和“添加portal型設(shè)備”接口文檔。

2. 網(wǎng)絡(luò)信息修改后，密碼型設(shè)備需同步修改所有設(shè)備的ssid或密碼；portal型設(shè)備需修改所有設(shè)備的ssid，并按照《硬件鑒權(quán)協(xié)議接口》修改“第二步：改造移動(dòng)端portal頁面”中的ssid參數(shù)，否則將無法正常連網(wǎng)。

接口調(diào)用說明

協(xié)議：https
http請(qǐng)求方式: POST
請(qǐng)求URL： https://api.weixin.qq.com/bizwifi/shop/update?access_token=ACCESS_TOKEN    
數(shù)據(jù)格式：JSON

請(qǐng)求參數(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)門店下有多個(gè)ssid時(shí)，必填
ssid	是	無線網(wǎng)絡(luò)設(shè)備的ssid。32個(gè)字符以內(nèi)；ssid支持中文，但可能因設(shè)備兼容性問題導(dǎo)致顯示亂碼，或無法連接等問題，相關(guān)風(fēng)險(xiǎn)自行承擔(dān)！當(dāng)門店下是portal型設(shè)備時(shí)，ssid必填；當(dāng)門店下是密碼型設(shè)備時(shí)，ssid選填，且ssid和密碼必須有一個(gè)以大寫字母“WX”開頭
password	否	無線網(wǎng)絡(luò)設(shè)備的密碼。8-24個(gè)字符；不能包含中文字符；當(dāng)門店下是密碼型設(shè)備時(shí)，才可填寫password，且ssid和密碼必須有一個(gè)以大寫字母“WX”開頭