7K
累计调用
94ms
平均响应
100.00%
服务可用性
20 次/日
免费额度
未携带 API Key
每天 5 次 · QPS 2
已登录(未开通会员)
每天 20 次 · QPS 3
免费试用
一次性 5 次
黄金会员
每天 2,000 次 · QPS 10
钻石会员
每天 5,000 次 · QPS 30
企业会员
每天 100,000 次 · QPS 60
未携带 API Key:每天 5 次 · QPS 2;已登录(未开通会员):每天 20 次 · QPS 3;试用:一次性 5 次;黄金会员:每天 2,000 次 · QPS 10;钻石会员:每天 5,000 次 · QPS 30;企业会员:每天 100,000 次 · QPS 60;点数:本接口不支持扣点;免费。完全免费。
必填 · 省 / 直辖市(中文名) · 示例:广东
必填 · 市(中文名) · 示例:深圳
可选 · 区 / 县(中文名),可提升定位精度与限行准确度 · 示例:南山
| 名称 | 类型 | 说明 |
|---|---|---|
| province(省) | string | 必填 · 省 / 直辖市(中文名) · 示例:广东 |
| city(城市) | string | 必填 · 市(中文名) · 示例:深圳 |
| county(区县) | string | 可选 · 区 / 县(中文名),可提升定位精度与限行准确度 · 示例:南山 |
可选 · 推荐: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_ 形态时生效)。匿名可不传,受每日免费额度限制。 |
查询位置 { province, city, county? }
province
城市
county
实时天气(weather/temperature/humidity/wind_direction/wind_power/update_time 等)
weather
temperature
humidity
wind_direction
wind_power
update_time
空气质量(aqi/level/quality/pm25/pm10/so2/no2/o3/co)
aqi
level
清晰度
pm25
pm10
未来 7 天预报(含昼夜天气、风向风力、最高/最低温)
date
temperature
min
max
未来 24 小时逐时预报
时间
temperature
weather
生活指数(穿衣/舒适/感冒/运动/紫外线等 23 项)
key
名称
level
detail
未来数日日出日落时间
date
sunrise
sunset
气象预警列表(无预警时为空数组)
alarm 的一项
机动车尾号限行(无则为 null)
tail_number
date
品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| location | object | 查询位置 { province, city, county? } | ||||||||||||||||||
| ||||||||||||||||||||
| observe | object | 实时天气(weather/temperature/humidity/wind_direction/wind_power/update_time 等) | ||||||||||||||||||
| ||||||||||||||||||||
| air | object | 空气质量(aqi/level/quality/pm25/pm10/so2/no2/o3/co) | ||||||||||||||||||
| ||||||||||||||||||||
| daily_forecast | array | 未来 7 天预报(含昼夜天气、风向风力、最高/最低温) | ||||||||||||||||||
| ||||||||||||||||||||
| hourly_forecast | array | 未来 24 小时逐时预报 | ||||||||||||||||||
| ||||||||||||||||||||
| life_index | array | 生活指数(穿衣/舒适/感冒/运动/紫外线等 23 项) | ||||||||||||||||||
| ||||||||||||||||||||
| sunrise_sunset | array | 未来数日日出日落时间 | ||||||||||||||||||
| ||||||||||||||||||||
| alarm | array | 气象预警列表(无预警时为空数组) | ||||||||||||||||||
| ||||||||||||||||||||
| limit | object | 机动车尾号限行(无则为 null) | ||||||||||||||||||
| ||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · https://apizero.cn | ||||||||||||||||||
{
"code": 0,
"msg": "成功",
"data": {
"location": {
"province": "广东",
"city": "深圳",
"county": "南山"
},
"observe": {
"weather": "多云",
"temperature": 30,
"humidity": 77,
"wind_direction": "北风",
"wind_power": "3-4",
"update_time": "2026-07-01 10:15"
},
"air": {
"aqi": 13,
"level": 1,
"quality": "优",
"pm25": 4,
"pm10": 12
},
"daily_forecast": [
{
"date": "2026-07-01",
"temperature": {
"min": 26,
"max": 33
}
}
],
"hourly_forecast": [
{
"time": "07-01 10:00",
"temperature": 30,
"weather": "多云"
}
],
"life_index": [
{
"key": "clothes",
"name": "穿衣",
"level": "炎热",
"detail": "..."
}
],
"sunrise_sunset": [
{
"date": "2026-07-01",
"sunrise": "05:43",
"sunset": "19:12"
}
],
"alarm": [],
"limit": {
"tail_number": "3和8",
"date": "2026-07-01"
}
},
"request_id": "abc123",
"tips": "极数本源 · https://apizero.cn"
}