万站API
支持全国2529个城市，包含基本天气、温度、风力风向等，可按地名、城市编号、IP查询。
国家级天气预报 是万站API开放平台提供的付费接口，支持 GET 请求，返回格式为 JSON。
你可以直接通过接口地址 https://wzapi.com/api/weather 进行调用，下方提供参数说明、返回示例与多语言代码样例，便于快速接入。
接口地址： https://wzapi.com/api/weather
返回格式： JSON
请求方式： GET
请求示例： https://wzapi.com/api/weather?apiKey=这里填写KEY&city=北京
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
apiKey | 是 | string | 用户密钥，付费接口必填 |
city | 否 | string | 城市名，可用「市」「区」「县」等关键词，如 北京、南京、海淀、浦东 |
stationid | 否 | string | 城市编号，与 city 二选一 |
ip | 否 | string | 传 1 时按访客 IP 自动定位 |
days | 否 | int | 预报天数，范围 1~7，默认 7 |
format | 否 | string | 输出格式，json（默认）或 text（纯文本框） |
pretty | 否 | string | 传 1 返回格式化 JSON，便于调试 |
city、stationid、ip三者可任选其一；都不传时自动按访客 IP 定位。
推荐使用 city，无需关心城市编号。| 字段名 | 类型 | 说明 |
|---|---|---|
ok | bool | 请求是否成功 |
data.station.province | string | 省份 |
data.station.city | string | 城市 |
data.update | string | 数据发布时间 |
data.now | object | 实时天气，见下表 |
data.warn | object | 预警信息，无预警时为 null |
data.forecast | array | 未来 7 天预报 |
data.hourly | array | 未来 24 小时逐小时预报 |
data.trend | array | 近 14 天气温走势 |
data.now 实时天气
| 字段名 | 类型 | 说明 |
|---|---|---|
temp | float | 当前温度（℃） |
text | string | 天气现象，如 多云、小雨 |
feels_like | float | 体感温度（℃） |
humidity | int | 相对湿度（%） |
rain | float | 降水量（mm） |
pressure | float | 气压（hPa），无数据时为 null |
comfort | int | 舒适度指数 |
wind_dir | string | 风向，如 西南风 |
wind_power | string | 风力，如 微风、3~4级 |
aqi | int | 空气质量指数 |
aqi_text | string | 空气质量等级，如 优、良 |
sunrise | string | 日出时间 |
sunset | string | 日落时间 |
data.warn 预警信息（无预警时为 null）
| 字段名 | 类型 | 说明 |
|---|---|---|
title | string | 预警标题 |
content | string | 预警内容 |
guide | string | 防御指南 |
level | string | 预警等级 |
type | string | 预警类型，如 暴雨、大风 |
data.forecast[] 逐日预报
| 字段名 | 类型 | 说明 |
|---|---|---|
date | string | 日期，格式 YYYY-MM-DD |
week | string | 星期，如 周一 |
text | string | 天气现象（综合） |
day_text | string | 白天天气 |
night_text | string | 夜间天气 |
high | int | 最高温（℃），无数据时为 null |
low | int | 最低温（℃） |
wind_dir | string | 风向 |
wind_power | string | 风力 |
precip | float | 降水量（mm） |
is_today | bool | 是否为今天 |
data.hourly[] 逐小时预报
| 字段名 | 类型 | 说明 |
|---|---|---|
time | string | 时间，格式 YYYY-MM-DD HH:mm |
temp | float | 温度（℃） |
humidity | int | 湿度（%） |
rain | float | 降水量（mm） |
wind_speed | float | 风速（m/s） |
data.trend[] 气温走势
| 字段名 | 类型 | 说明 |
|---|---|---|
date | string | 日期，格式 YYYY-MM-DD |
max | float | 当日最高温（℃） |
min | float | 当日最低温（℃） |
```json
{
"ok": true,
"data": {
"station": {
"province": "北京市",
"city": "北京"
},
"update": "2026-09-21 00:45",
"now": {
"temp": 21.3,
"text": "多云",
"feels_like": 23.7,
"humidity": 86,
"rain": 0,
"pressure": null,
"comfort": 65,
"wind_dir": "西南风",
"wind_power": "微风",
"aqi": 60,
"aqi_text": "良",
"sunrise": "2026-09-21 06:00",
"sunset": "2026-09-21 18:13"
},
"warn": null,
"forecast": [
{
"date": "2026-09-20",
"week": "周日",
"text": "多云",
"day_text": "多云",
"night_text": "多云",
"high": null,
"low": 18,
"wind_dir": "西南风",
"wind_power": "微风",
"precip": 0,
"is_today": true
},
{
"date": "2026-09-21",
"week": "周一",
"text": "晴",
"day_text": "晴",
"night_text": "晴",
"high": 29,
"low": 18,
"wind_dir": "南风",
"wind_power": "微风",
"precip": 0,
"is_today": false
},
{
"...": "其余 5 天"
}
],
"hourly": [
{
"time": "2026-09-21 00:00",
"temp": 22.1,
"humidity": 83,
"rain": 0,
"wind_speed": 1.8
},
{
"...": "其余 23 条"
}
],
"trend": [
{
"date": "2026-09-13",
"max": 30.5,
"min": 16.5
},
{
"...": "其余 13 条"
}
]
}
}
```
> 为便于阅读，`forecast` / `hourly` / `trend` 均只展示首条，实际返回完整数据。
### text 格式返回
传 `format=text` 时返回纯文本，适合直接推送到终端、钉钉/企业微信机器人：
`GET https://wzapi.com/api/weather?apiKey=这里填写KEY&city=南京&format=text`
```text
╭─ 江苏省·南京 实时天气
│ 发布 2026-09-21 00:45
│ 23.4℃ 多云
│ 体感 27℃ 湿度 95% 降水 0mm
│ 风 西北风 微风
│ 空气 38 优
│ 日出 05:51 日落 18:03
├─────────────────────────────
│ 09-20 周日 22℃ -- 阴
│ ●──────────────── 东风 微风
│ 09-21 周一 22℃ 27℃ 阴转多云
│ ─────────●─────── 东北风 3~4级
│ 09-22 周二 22℃ 27℃ 阴
│ ─────────●─────── 东北风 微风
│ 09-23 周三 23℃ 28℃ 小雨转多云
│ ───────────●───── 东风 微风
│ 09-24 周四 22℃ 24℃ 晴转中雨
│ ────●──────────── 东风 3~4级
│ 09-25 周五 24℃ 31℃ 小雨转阴
│ ────────────────● 东南风 微风
│ 09-26 周六 24℃ 28℃ 小雨
│ ───────────●───── 西北风 微风
╰─────────────────────────────
```
| 参数名 | 参数值 | 操作 |
|---|
```json
{
"ok": true,
"data": {
"station": {
"province": "北京市",
"city": "北京"
},
"update": "2026-09-21 00:45",
"now": {
"temp": 21.3,
"text": "多云",
"feels_like": 23.7,
"humidity": 86,
"rain": 0,
"pressure": null,
"comfort": 65,
"wind_dir": "西南风",
"wind_power": "微风",
"aqi": 60,
"aqi_text": "良",
"sunrise": "2026-09-21 06:00",
"sunset": "2026-09-21 18:13"
},
"warn": null,
"forecast": [
{
"date": "2026-09-20",
"week": "周日",
"text": "多云",
"day_text": "多云",
"night_text": "多云",
"high": null,
"low": 18,
"wind_dir": "西南风",
"wind_power": "微风",
"precip": 0,
"is_today": true
},
{
"date": "2026-09-21",
"week": "周一",
"text": "晴",
"day_text": "晴",
"night_text": "晴",
"high": 29,
"low": 18,
"wind_dir": "南风",
"wind_power": "微风",
"precip": 0,
"is_today": false
},
{
"...": "其余 5 天"
}
],
"hourly": [
{
"time": "2026-09-21 00:00",
"temp": 22.1,
"humidity": 83,
"rain": 0,
"wind_speed": 1.8
},
{
"...": "其余 23 条"
}
],
"trend": [
{
"date": "2026-09-13",
"max": 30.5,
"min": 16.5
},
{
"...": "其余 13 条"
}
]
}
}
```
> 为便于阅读，`forecast` / `hourly` / `trend` 均只展示首条，实际返回完整数据。
### text 格式返回
传 `format=text` 时返回纯文本，适合直接推送到终端、钉钉/企业微信机器人：
`GET https://wzapi.com/api/weather?apiKey=这里填写KEY&city=南京&format=text`
```text
╭─ 江苏省·南京 实时天气
│ 发布 2026-09-21 00:45
│ 23.4℃ 多云
│ 体感 27℃ 湿度 95% 降水 0mm
│ 风 西北风 微风
│ 空气 38 优
│ 日出 05:51 日落 18:03
├─────────────────────────────
│ 09-20 周日 22℃ -- 阴
│ ●──────────────── 东风 微风
│ 09-21 周一 22℃ 27℃ 阴转多云
│ ─────────●─────── 东北风 3~4级
│ 09-22 周二 22℃ 27℃ 阴
│ ─────────●─────── 东北风 微风
│ 09-23 周三 23℃ 28℃ 小雨转多云
│ ───────────●───── 东风 微风
│ 09-24 周四 22℃ 24℃ 晴转中雨
│ ────●──────────── 东风 3~4级
│ 09-25 周五 24℃ 31℃ 小雨转阴
│ ────────────────● 东南风 微风
│ 09-26 周六 24℃ 28℃ 小雨
│ ───────────●───── 西北风 微风
╰─────────────────────────────
```