城市空气质量
### 城市空气质量 查询城市空气质量：AQI、首要污染物、健康指引等（端点待与聚合文档核对） ### 请求示例 `GET /v1/aqi?key=你的key&city=示例值` ### 请求参数 | 参数 | 必填 | 类型 | 说明 | |---|---|---|---| | city | 是 | string | 城市中文名，如 苏州 | ### 返回说明 统一响应结构 `{code, msg, data}`，`code=0` 表示成功，业务数据在 `data` 中： ```json {"code":0,"msg":"success","data":{"city":{"cityname":"苏州"},"dataList":[{"AQI":"52","quality":"良"}]}} ```
请求参数
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
city |
是 | string | 城市中文名，如 苏州 |
签名算法
1. 将所有请求参数（除 sign 外）按参数名 ASCII 升序排列
2. 拼接成 key1=value1&key2=value2&... 格式
3. 在拼接串末尾追加 API密钥（apiKey），无需 & 连接
4. 对最终字符串进行 MD5 加密，取 32 位小写十六进制
响应示例
{"reason": "success", "error_code": 0, "result": {"city": {"cityname": "苏州"}, "dataList": [{"AQI": "52", "quality": "良", "primaryPollutant": "O3", "advice": "极少数异常敏感人群应减少户外活动"}]}}
状态码说明
| code | 说明 |
|---|---|
| 0 | 请求成功 |
| -1 | 请求失败（msg 中包含具体原因） |
订单状态
| status | 含义 | 说明 |
|---|---|---|
| 1 | 待处理 | 订单已受理，等待处理 |
| 2 | 处理中 | 订单正在充值处理中 |
| 3 | 成功 | 充值成功 |
| 4 | 失败 | 充值失败（余额会自动退回） |