# 查询WI-FI状态
表1查询Wi-Fi状态 
| **REST URL格式** |    **访问方法**    |                        **URI**                        ||||
| **REST URL格式** |
|---|---|---|---|---|---|
| POST           | ~https://ip/v1/om/config~                        ||||
| **接口功能**       | 查询Wi-Fi状态信息                                                           |||||
| **接口说明**       | 查询Wi-Fi状态信息，包括Wi-Fi客户端启用状态、Wi-Fi网络优先状态、Wi-Fi网络模式、IP地址、子网掩码、网关地址、DNS服务器1、DNS服务器2、DNS服务器3 |||||
| **响应数据**       | 参见[表2], [表3] |||||
| **参数**         | **参数名称**       | **可选/必选/条件必选** | **参数类型** | **位置** | **参数说明**            |
| **参数**         | enableWifi     | 可选             | int      | 无      | WiFi客户端启用状态 0禁用 1启用 |
| **参数**         | isWifiPriority | 可选             | int      | 无      | WiFi网络优先状态 0否 1是    |
| **参数**         | staNetModeIpv4 | 可选             | int      | 无      | 网络模式 0静态 1动态        |
| **参数**         | staIpv4Addr    | 可选             | String   | 无      | IP地址                |
| **参数**         | staIpv4Mask    | 可选             | String   | 无      | 子网掩码                |
| **参数**         | staIpv4GW      | 可选             | String   | 无      | 网关地址                |
| **参数**         | dns0           | 可选             | String   | 无      | DNS服务器地址1           |
| **参数**         | dns1           | 可选             | String   | 无      | DNS服务器地址2           |
| **参数**         | dns2           | 可选             | String   | 无      | DNS服务器地址3           |
| **请求消息**       | Header: Cookie: SessionID=xxx Content-Type: application/json; charset=UTF-8 X-Access-Token: xxx Body: { "cfgIDString":\[ "enableWifi", "isWifiPriority", "staNetModeIpv4", "staIpv4Addr", "staIpv4Mask", "staIpv4GW", "dns0", "dns1", "dns2" \] } |||||
   
 表2返回值 
| 参数      | 类型     | 取值范围     | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| success | int    | \[0, 1\] | 响应结果 0：失败 1：成功                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| data    | Object | 可选       | 成功返回数据。 例如： { "success":1, "data":"{ \\"enableWifi\\":1, \\"isWifiPriority\\":1, \\"staNetModeIpv4\\":1, \\"staIpv4Addr\\":\\"127.0.0.1\\", \\"staIpv4Mask\\":\\"255.255.255.0\\", \\"staIpv4GW\\":\\"127.0.0.2\\", \\"dns0\\":\\"172.16.1.1\\", \\"dns1\\":\\"172.16.1.2\\", \\"dns2\\":\\"172.16.1.3\\" }" } |
| 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 对象 | 失败响应的附带参数。                                                                                                              |