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. |