This API is used to query the information of the device that is successfully connected in the specified store under the current MP account by using a specified page or store ID. You can query the device information of up to 20 stores.

API Request Format

Protocol: HTTPS
HTTP request method: POST
Request URL: https://api.weixin.qq.com/bizwifi/device/list?access_token=ACCESS_TOKEN
POST data format: JSON

Request Parameters

Parameter Required Description
access_token Yes The credential for calling the API
POST data Yes JSON data

POST Data

Example:

Query with a page:
{
   "pageindex": 1,		
   "pagesize":10
}
Query with store ID:
{
   "pageindex": 1,		
   "pagesize":10,
   "shop_id":429620
}

Fields:

Field Required Description
pageindex No Page subscript, which begins from 1 by default.
pagesize No Number of stores displayed per page. It defaults to 10. Maximum is 20.
shop_id No The store ID used for query

Response

The JSON data returned for a successful request:

{
   "errcode": 0,
   "data": {
     "totalcount": 2,
     "pageindex": 1,
     "pagecount": 1,
     "records": [
       {
         "shop_id": 429620,
         "ssid": "WX123",
         "bssid": "00:1f:7a:ad:5b:a9",
         "protocol_type":4
       },
       {
         "shop_id": 429620,
         "ssid": "WX123",
         "bssid": "00:1f:7a:ad:5c:a8",
         "protocol_type":4
       }
     ]
   }
}

Fields:

Field Description
totalcount Total number of stores
pageindex Page subscript
pagecount Total number of pages
records Array of store lists on the current page
shop_id Store ID
ssid SSID of the connected device
bssid Wireless MAC address
protocol_type The type of device in the store. 0: No device added; 4: Password-based device; 31: Portal-based device.