提供全国 2,800+ 个城市及区县的实时天气、未来 7 日预报、24 小时逐时预报与生活指数查询。数据来源于气象部门公开数据并经多源交叉校验，每 10 分钟更新一次，适用于出行、物流、农业、零售等业务场景。
天气预报 API 通过标准 HTTP GET 请求返回结构化 JSON 数据，支持按城市名称、行政区划编码（adcode）或经纬度三种方式定位。单次请求可返回实时天气与多日预报，字段涵盖温度、天气现象、风力风向、湿度、气压、能见度及穿衣、洗车、紫外线等 8 类生活指数。接口全程 HTTPS 加密传输，支持高并发调用，可稳定用于生产环境。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥，在控制台「应用管理」中创建应用后获取。 |
| city | string | 是 | 城市名称，如「杭州」「北京市」，与 adcode 二选一填写。 |
| adcode | string | 否 | 行政区划编码（6 位），如 330100，与 city 二选一，优先级高于 city。 |
| type | string | 否 | 返回类型：base=实时天气（默认）、forecast=7 日预报、hourly=逐时预报。 |
| extensions | string | 否 | 是否返回生活指数：0=不返回（默认）、1=返回穿衣、洗车等 8 类指数。 |
| output | string | 否 | 返回格式：JSON（默认）或 XML。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示请求成功，其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.city | string | 查询城市名称。 |
| data.adcode | string | 城市行政区划编码。 |
| data.temp | string | 实时温度，单位摄氏度（℃）。 |
| data.weather | string | 天气现象，如晴、多云、小雨。 |
| data.humidity | string | 相对湿度百分比。 |
| data.wind | string | 风向与风力等级，如「东南风 2 级」。 |
| data.forecast | array | 未来 7 日预报数组（type=forecast 时返回）。 |
| data.update_time | string | 数据更新时间，格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"city": "杭州",
"adcode": "330100",
"temp": "26",
"weather": "晴",
"humidity": "58",
"wind": "东南风 2 级",
"forecast": [
{ "date": "2026-07-25", "high": "31", "low": "25", "weather": "晴" },
{ "date": "2026-07-26", "high": "32", "low": "26", "weather": "多云" }
],
"update_time": "2026-07-25 14:20:00"
}
}