
# 查询wifi列表
表1查询wifi列表 
| **REST URL格式** | **访问方法** |  **URI**   ||||
| **REST URL格式** |
|---|---|---|---|---|---|
| GET            | ~https://ip/v1/om/network/wifi~ ||||
| **接口功能**       | 查询wifi列表             |||||
| **接口说明**       | 查询Wi-Fi列表信息，包括SSID号、信道、安全类型、MAC地址、信号强度。 |||||
| **响应数据**       | 参见[表2] , [表3] |||||
| **参数**         | NA                   |||||
| **请求消息**       | Header: Cookie: SessionID=xxx Content-Type: application/json; charset=UTF-8 X-Access-Token: xxx Body:{} |||||
   
 表2返回值 
| 参数      | 类型     | 取值范围     | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| success | int    | \[0, 1\] | 响应结果 0：失败 1：成功                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| data    | Object | 可选       | 成功返回数据 例如：  "success":1, "data":"{ \\"count\\":1, \\"frequencyMode\\":1, \\"wifiApList\\":\[{ \\"ssidName\\":\\"Test-WiFi\\", \\"channel\\":64, \\"identMode\\":6, \\"macAddress\\":\\"02:aa:xx:xx:xx:12\\", \\"sigStrength\\":-42, \\"protoType\\":1, \\"encryptType\\":3, \\"connSpeed\\":255, \\"saveAp\\":0 }\] }" } 备注： count wifi列表数目 frequencyMode 保留字段, 0-Auto, 1-5GHz, 2-2.4GHz ssidName Wi-Fi名称 channel 使用的信道 identMode 认证方式（0-OPEN, 1-SHARE, 3-WPA-PSK, 6-WPA2-PSK，4,7,8-802.1x EAP, 9-WPA-PSK/WPA2-PSK） macAddress MAC地址 sigStrength 信号强度 protoType 保留字段, 协议类型, 0-OPEN,1-802.11b, 4-802.11g, 6-802.11n, 9-802.11b/g/n encryptType 保留字段, 加密类型, 0-NONE, 1-WEP, 2-TKIP, 3-AES connSpeed 保留字段, 连接速度 saveAp 保留字段, 是否已保存此AP, 0 否 1 是 |
| error   | Object | 可选       | 失败返回错误信息。参见[表3] 例如：{"success":0,"error":{"id":100666744,"code":134250502,"params":\[\]}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
 表3error 
| 参数    | 类型     | 取值范围     | 参数说明                                                                                                                    |
|:---|:---|:---|:---|
| id    | int    | 32位整数    | 错误id，用于转换。                                                                                                              |
| code  | int    | 32位整数    | 错误码，跟错误id对应，具体含义参考[错误码](https://support.huaweicloud.com/ideahub-api/ideahub_05_0255.html#ZH-CN_TOPIC_0000001309671920)。 |
| param | Object | param 对象 | 失败响应的附带参数。                                                                                                              |
   
