加载接口文档…
彩云天气
API全功能天气接口，覆盖： • 实时天气（温度/湿度/风/能见度/AQI/PM2.5） • 分钟级降水预报（未来 2 小时） • 小时预报（最长 360 小时 = 15 天） • 天预报（最长 15 天，含日出日落、温度极值、生活指数） • 综合数据（一次返回全部 + 气象预警） 特…
由 极数本源 提供·更新于 今天
4.2M
累计调用
197ms
平均响应
99.67%
服务可用性
2,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 100 次 · QPS 2
登录免费
当前方案每日 2,000 次 · QPS 3
黄金会员
每日 50,000 次 · QPS 10
钻石会员
每日 100,000 次 · QPS 30
企业会员
企业接口额度 · QPS 120
接入文档
在线工具
接口请求地址
https://v1.apizero.cn/api/weather
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/weather?type=weather&city=%E5%8C%97%E4%BA%AC&location=116.3975%2C39.9085&alert=true&days=7&hours=48
接口信息备注
一次返回实时 + 分钟降水 + 小时/天预报 + 气象预警摘要。type 默认 weather。city 与 location 二选一。文档示例为北京真实数据（预报序列已截断）。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| type（类型） | string | 可选 · 固定为 weather：综合数据包 · 默认 weather · 示例：weather |
| city（城市） | string | 可选 · 城市/地区名称，与 location 二选一 · 示例：北京 |
| location（经纬度） | string | 可选 · 经纬度「经度,纬度」，优先级高于 city · 示例：116.3975,39.9085 |
| alert（预警） | boolean | 可选 · 是否附带气象预警 · 默认 true · 示例：true |
| days（天数） | integer | 可选 · 天预报天数 1–15 · 默认 7 · 示例：7 |
| hours（小时数） | integer | 可选 · 小时预报小时数，最长 360 · 默认 24 · 示例：48 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| type | string | 查询类型，此处为 weather |
| location | object | 城市、经纬度、时区 |
| server_time | integer | 服务端时间戳 |
| forecast_keypoint | string | 一句话天气总结 |
| summary | object | 一眼可读的实时摘要（温度/天气/风/AQI） |
| alerts | array | 气象预警列表 |
| realtime | object | 实时天气原始字段 |
| minutely | object | 分钟级降水（仅综合包） |
| hourly | object | 小时预报 |
| daily | object | 天预报 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"type": "weather",
"location": {
"city": "北京",
"longitude": 116.4074,
"latitude": 39.9042,
"timezone": "Asia/Shanghai"
},
"server_time": "2026-07-31 04:10:38",
"forecast_keypoint": "多云，今天晚间23点钟后转小雨，其后多云",
"summary": {
"city": "北京",
"skycon": "多云",
"skycon_emoji": "☁️",
"skycon_code": "PARTLY_CLOUDY_NIGHT",
"temperature": 28.8,
"apparent_temperature": 32.6,
"humidity_percent": 81,
"cloudrate_percent": 29,
"visibility_km": 8.2,
"wind": {
"speed_ms": 5.6,
"direction_deg": 199.6,
"direction_text": "西南偏南风",
"level": 4,
"level_text": "和风"
},
"air_quality": {
"aqi": 36,
"level": "优",
"level_color": "green",
"pm25": 15
},
"alert_count": 0
},
"alerts": [],
"realtime": {
"status": "ok",
"temperature": 28.76,
"humidity": 0.81,
"cloudrate": 0.29,
"skycon": "PARTLY_CLOUDY_NIGHT",
"visibility": 8.19,
"dswrf": 0,
"wind": {
"speed": 5.58,
"direction": 199.6
},
"pressure": 99652.7,
"apparent_temperature": 32.6,
"precipitation": {
"local": {
"status": "ok",
"datasource": "radar",
"intensity": 0
},
"nearest": {
"status": "ok",
"distance": 144.37,
"intensity": 0.1875
}
},
"air_quality": {
"pm25": 15,
"pm10": 36,
"o3": 57,
"so2": 1,
"no2": 18,
"co": 0.5,
"aqi": {
"chn": 36,
"usa": 61
},
"description": {
"chn": "优",
"usa": "良"
}
},
"life_index": {
"ultraviolet": {
"index": 0,
"desc": "无"
},
"comfort": {
"index": 0,
"desc": "闷热"
}
}
},
"minutely": {
"status": "ok",
"datasource": "radar",
"precipitation_2h": [
0,
0,
0,
0,
0,
0,
0,
0
],
"precipitation": [
0,
0,
0
],
"accumulation": [
0,
0
],
"probability": [
0,
0,
0,
0
],
"description": "未来两小时不会有雨。夜深了，注意休息哦～"
},
"hourly": {
"status": "ok",
"description": "多云，今天晚间23点钟后转小雨，其后多云",
"precipitation": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0,
"probability": 0
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0,
"probability": 0
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0,
"probability": 0
}
],
"temperature": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 28.76
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 28.44
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 28.32
}
],
"apparent_temperature": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 32.6
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 32.7
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 32.6
},
{
"datetime": "2026-07-31T07:00+08:00",
"value": 33
},
{
"datetime": "2026-07-31T08:00+08:00",
"value": 33.8
},
{
"datetime": "2026-07-31T09:00+08:00",
"value": 34.7
}
],
"wind": [
{
"datetime": "2026-07-31T04:00+08:00",
"speed": 5.58,
"direction": 199.6
},
{
"datetime": "2026-07-31T05:00+08:00",
"speed": 4.61,
"direction": 187.18
},
{
"datetime": "2026-07-31T06:00+08:00",
"speed": 4.83,
"direction": 194.24
}
],
"humidity": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0.81
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0.86
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.87
}
],
"cloudrate": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0.29
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0.29
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.8
}
],
"skycon": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": "PARTLY_CLOUDY_NIGHT"
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": "PARTLY_CLOUDY_NIGHT"
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": "PARTLY_CLOUDY_DAY"
}
],
"pressure": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 99652.7
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 99625.53
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 99621.15
}
],
"visibility": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 8.19
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 8.12
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 0.62
}
],
"dswrf": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 0
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 0
},
{
"datetime": "2026-07-31T06:00+08:00",
"value": 37.953125
}
],
"air_quality": {
"aqi": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": {
"chn": 36,
"usa": 61
}
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": {
"chn": 47,
"usa": 71
}
}
],
"pm25": [
{
"datetime": "2026-07-31T04:00+08:00",
"value": 15
},
{
"datetime": "2026-07-31T05:00+08:00",
"value": 22
}
]
}
},
"daily": {
"status": "ok",
"astro": [
{
"date": "2026-07-31T00:00+08:00",
"sunrise": {
"time": "05:11"
},
"sunset": {
"time": "19:29"
}
},
{
"date": "2026-08-01T00:00+08:00",
"sunrise": {
"time": "05:12"
},
"sunset": {
"time": "19:28"
}
},
{
"date": "2026-08-02T00:00+08:00",
"sunrise": {
"time": "05:13"
},
"sunset": {
"time": "19:27"
}
}
],
"precipitation_08h_20h": [
{
"date": "2026-07-31T00:00+08:00",
"max": 0,
"min": 0,
"avg": 0,
"probability": 0
},
{
"date": "2026-08-01T00:00+08:00",
"max": 0.4096,
"min": 0,
"avg": 0.0341,
"probability": 60
},
{
"date": "2026-08-02T00:00+08:00",
"max": 1.8265,
"min": 0,
"avg": 0.5487,
"probability": 70
}
],
"precipitation_20h_32h": [
{
"date": "2026-07-31T00:00+08:00",
"max": 3.6836,
"min": 0,
"avg": 0.6972,
"probability": 70
},
{
"date": "2026-08-01T00:00+08:00",
"max": 1.1707,
"min": 0,
"avg": 0.1741,
"probability": 60
},
{
"date": "2026-08-02T00:00+08:00",
"max": 4.1774,
"min": 0,
"avg": 0.4281,
"probability": 60
}
],
"precipitation": [
{
"date": "2026-07-31T00:00+08:00",
"max": 0.9151,
"min": 0,
"avg": 0.0458,
"probability": 60
},
{
"date": "2026-08-01T00:00+08:00",
"max": 3.6836,
"min": 0,
"avg": 0.3275,
"probability": 60
},
{
"date": "2026-08-02T00:00+08:00",
"max": 1.8265,
"min": 0,
"avg": 0.4506,
"probability": 70
}
],
"temperature": [
{
"date": "2026-07-31T00:00+08:00",
"max": 32.97,
"min": 27.63,
"avg": 30.4
},
{
"date": "2026-08-01T00:00+08:00",
"max": 32.08,
"min": 25.93,
"avg": 28.99
},
{
"date": "2026-08-02T00:00+08:00",
"max": 33.45,
"min": 26.76,
"avg": 29.39
}
],
"temperature_08h_20h": [
{
"date": "2026-07-31T00:00+08:00",
"max": 32.97,
"min": 28.59,
"avg": 31.54
},
{
"date": "2026-08-01T00:00+08:00",
"max": 32.08,
"min": 26.59,
"avg": 30.26
},
{
"date": "2026-08-02T00:00+08:00",
"max": 33.45,
"min": 27.39,
"avg": 30.84
}
],
"temperature_20h_32h": [
{
"date": "2026-07-31T00:00+08:00",
"max": 29.71,
"min": 25.93,
"avg": 27.38
},
{
"date": "2026-08-01T00:00+08:00",
"max": 30.74,
"min": 26.76,
"avg": 28.39
},
{
"date": "2026-08-02T00:00+08:00",
"max": 29.32,
"min": 26.49,
"avg": 27.33
}
],
"wind": [
{
"date": "2026-07-31T00:00+08:00",
"max": {
"speed": 9.44,
"direction": 219.58
},
"min": {
"speed": 3.39,
"direction": 197.28
},
"avg": {
"speed": 6.19,
"direction": 193.96
}
},
{
"date": "2026-08-01T00:00+08:00",
"max": {
"speed": 6.31,
"direction": 182.94
},
"min": {
"speed": 1.43,
"direction": 40.91
},
"avg": {
"speed": 3.88,
"direction": 179.33
}
},
{
"date": "2026-08-02T00:00+08:00",
"max": {
"speed": 7.42,
"direction": 178.05
},
"min": {
"speed": 1.81,
"direction": 47.42
},
"avg": {
"speed": 3.64,
"direction": 154.29
}
}
],
"wind_08h_20h": [
{
"date": "2026-07-31T00:00+08:00",
"max": {
"speed": 9.44,
"direction": 219.58
},
"min": {
"speed": 3.39,
"direction": 197.28
},
"avg": {
"speed": 6.77,
"direction": 189.98
}
},
{
"date": "2026-08-01T00:00+08:00",
"max": {
"speed": 6.31,
"direction": 182.94
},
"min": {
"speed": 1.43,
"direction": 40.91
},
"avg": {
"speed": 2.92,
"direction": 164.04
}
},
{
"date": "2026-08-02T00:00+08:00",
"max": {
"speed": 7.42,
"direction": 178.05
},
"min": {
"speed": 2.89,
"direction": 3.58
},
"avg": {
"speed": 3.27,
"direction": 172
}
}
],
"wind_20h_32h": [
{
"date": "2026-07-31T00:00+08:00",
"max": {
"speed": 6.16,
"direction": 201.61
},
"min": {
"speed": 2.17,
"direction": 184.76
},
"avg": {
"speed": 4.41,
"direction": 203.52
}
},
{
"date": "2026-08-01T00:00+08:00",
"max": {
"speed": 5.17,
"direction": 205.14
},
"min": {
"speed": 1.81,
"direction": 47.42
},
"avg": {
"speed": 2.73,
"direction": 152.69
}
},
{
"date": "2026-08-02T00:00+08:00",
"max": {
"speed": 7.07,
"direction": 26.62
},
"min": {
"speed": 1.99,
"direction": 84.81
},
"avg": {
"speed": 5.19,
"direction": 38.41
}
}
],
"humidity": [
{
"date": "2026-07-31T00:00+08:00",
"max": 0.87,
"min": 0.56,
"avg": 0.7
},
{
"date": "2026-08-01T00:00+08:00",
"max": 0.86,
"min": 0.57,
"avg": 0.74
},
{
"date": "2026-08-02T00:00+08:00",
"max": 0.87,
"min": 0.55,
"avg": 0.74
}
],
"cloudrate": [
{
"date": "2026-07-31T00:00+08:00",
"max": 1,
"min": 0.07,
"avg": 0.49
},
{
"date": "2026-08-01T00:00+08:00",
"max": 0.92,
"min": 0,
"avg": 0.39
},
{
"date": "2026-08-02T00:00+08:00",
"max": 1,
"min": 0.77,
"avg": 0.99
}
],
"pressure": [
{
"date": "2026-07-31T00:00+08:00",
"max": 99755.52,
"min": 99330.88,
"avg": 99516.91
},
{
"date": "2026-08-01T00:00+08:00",
"max": 99706.07,
"min": 99385.45,
"avg": 99525.87
},
{
"date": "2026-08-02T00:00+08:00",
"max": 99979.26,
"min": 99645.55,
"avg": 99818.24
}
],
"visibility": [
{
"date": "2026-07-31T00:00+08:00",
"max": 24.18,
"min": 0.62,
"avg": 15.59
},
{
"date": "2026-08-01T00:00+08:00",
"max": 29.1,
"min": 5.83,
"avg": 19.48
},
{
"date": "2026-08-02T00:00+08:00",
"max": 24.14,
"min": 0.23,
"avg": 15.4
}
],
"dswrf": [
{
"date": "2026-07-31T00:00+08:00",
"max": 776.5,
"min": 0,
"avg": 229.5
},
{
"date": "2026-08-01T00:00+08:00",
"max": 782,
"min": 0,
"avg": 214.2
},
{
"date": "2026-08-02T00:00+08:00",
"max": 604.5,
"min": 0,
"avg": 138.5
}
],
"air_quality": {
"aqi": [
{
"date": "2026-07-31T00:00+08:00",
"max": {
"chn": 53,
"usa": 86
},
"avg": {
"chn": 47,
"usa": 77
},
"min": {
"chn": 36,
"usa": 61
}
},
{
"date": "2026-08-01T00:00+08:00",
"max": {
"chn": 53,
"usa": 102
},
"avg": {
"chn": 50,
"usa": 90
},
"min": {
"chn": 43,
"usa": 86
}
}
],
"pm25": [
{
"date": "2026-07-31T00:00+08:00",
"max": 29,
"avg": 24,
"min": 15
},
{
"date": "2026-08-01T00:00+08:00",
"max": 36,
"avg": 31,
"min": 29
}
]
},
"skycon": [
{
"date": "2026-07-31T00:00+08:00",
"value": "LIGHT_RAIN"
},
{
"date": "2026-08-01T00:00+08:00",
"value": "LIGHT_RAIN"
},
{
"date": "2026-08-02T00:00+08:00",
"value": "MODERATE_RAIN"
}
],
"skycon_08h_20h": [
{
"date": "2026-07-31T00:00+08:00",
"value": "PARTLY_CLOUDY_DAY"
},
{
"date": "2026-08-01T00:00+08:00",
"value": "LIGHT_RAIN"
},
{
"date": "2026-08-02T00:00+08:00",
"value": "MODERATE_RAIN"
}
],
"skycon_20h_32h": [
{
"date": "2026-07-31T00:00+08:00",
"value": "MODERATE_RAIN"
},
{
"date": "2026-08-01T00:00+08:00",
"value": "LIGHT_RAIN"
},
{
"date": "2026-08-02T00:00+08:00",
"value": "LIGHT_RAIN"
}
],
"life_index": {
"ultraviolet": [
{
"date": "2026-07-31T00:00+08:00",
"index": "1",
"desc": "最弱"
},
{
"date": "2026-08-01T00:00+08:00",
"index": "2",
"desc": "弱"
}
],
"carWashing": [
{
"date": "2026-07-31T00:00+08:00",
"index": "3",
"desc": "较不适宜"
},
{
"date": "2026-08-01T00:00+08:00",
"index": "3",
"desc": "较不适宜"
}
],
"dressing": [
{
"date": "2026-07-31T00:00+08:00",
"index": "2",
"desc": "很热"
},
{
"date": "2026-08-01T00:00+08:00",
"index": "2",
"desc": "很热"
}
]
}
}
},
"request_id": "ms7y7k0z8731cc94",
"tips": "极数本源 · https://apizero.cn"
}