加载接口文档…
彩云天气
API全功能天气接口，覆盖： • 实时天气（温度/湿度/风/能见度/AQI/PM2.5） • 分钟级降水预报（未来 2 小时） • 小时预报（最长 360 小时 = 15 天） • 天预报（最长 15 天，含日出日落、温度极值、生活指数） • 综合数据（一次返回全部 + 气象预警） 特…
由 极数本源 提供·更新于 今天
5.1M
累计调用
159ms
平均响应
100.00%
服务可用性
2,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每天 100 次 · QPS 2
登录免费
当前方案每天 2,000 次 · QPS 3
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 120
接入文档
接口请求地址
https://v1.apizero.cn/api/weather
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/weather?type=minutely&city=%E5%8C%97%E4%BA%AC&location=116.3975%2C39.9085
接口信息备注
未来约 2 小时分钟级降水强度预报，适合短时出行决策。示例为北京真实抓取。
请求参数说明
type（类型）string
必填 · 固定为 minutely · 示例：minutely
city（城市）string
可选 · 城市名 · 示例：北京
location（经纬度）string
可选 · 经纬度 · 示例：116.3975,39.9085
| 名称 | 类型 | 说明 |
|---|---|---|
| type（类型） | string | 必填 · 固定为 minutely · 示例：minutely |
| city（城市） | string | 可选 · 城市名 · 示例：北京 |
| location（经纬度） | string | 可选 · 经纬度 · 示例：116.3975,39.9085 |
请求头说明
Authorizationstring
可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
typestring
minutely
forecast_keypointstring
短时降水一句话提示
minutelyobject
分钟降水序列与描述文案
statusstring
状态
datasourcestring
datasource
precipitation_2harray
precipitation_2h
minutely.precipitation_2h[]number
minutely.precipitation_2h 的一项
precipitationarray
precipitation
minutely.precipitation[]number
minutely.precipitation 的一项
accumulationarray
accumulation
minutely.accumulation[]number
minutely.accumulation 的一项
probabilityarray
probability
minutely.probability[]number
minutely.probability 的一项
descriptionstring
description
summaryobject
实时摘要（若有）
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| type | string | minutely | |||||||||||||||||||||||||||||||||||||||||||||
| forecast_keypoint | string | 短时降水一句话提示 | |||||||||||||||||||||||||||||||||||||||||||||
| minutely | object | 分钟降水序列与描述文案 | |||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||
| summary | object | 实时摘要（若有） | |||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | |||||||||||||||||||||||||||||||||||||||||||||
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"type": "minutely",
"location": {
"city": "北京",
"longitude": 116.4074,
"latitude": 39.9042,
"timezone": "Asia/Shanghai"
},
"server_time": "2026-07-31 04:10:48",
"forecast_keypoint": "未来两小时不会有雨。夜深了，注意休息哦～",
"summary": null,
"alerts": [],
"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": "未来两小时不会有雨。夜深了，注意休息哦～"
}
},
"request_id": "ms7y7rl986e4627d",
"tips": "极数本源 · https://apizero.cn"
}