接入平台气象数据,支持全国 3 万+ 城市实况、历史天气、未来 7 天、24 小时趋势、AQI、9 项生活指数、气象预警及农历,一次调用全量返回。 支持 4 种查询模式: - ?city=北京 · 按城市名查实况(自动模糊匹配第一个) - ?id=33 · 按 internal …
由 极数本源 提供·更新于 昨天
3万
累计调用
152ms
平均响应
100.00%
服务可用性
3,000 次/日
免费额度
无 Key 调用
每天 1,000 次 · 每秒 2 次
登录免费
当前方案每天 3,000 次 · 每秒 3 次
黄金会员
每天 50,000 次 · 每秒 10 次
钻石会员
每天 100,000 次 · 每秒 30 次
企业会员
企业接口额度 · QPS 120
缺省模式:按城市名或 internal_id 查询实况,返回实况/未来7天/24h/AQI/预警/生活指数。city 与 id 二选一。文档示例为北京真实抓取(预报序列已截断)。
可选 · 城市中文名(如「北京」「杭州」);与 id 二选一 · 示例:北京
可选 · 城市 internal_id(可先调城市搜索);与 city 二选一 · 示例:33
| 名称 | 类型 | 说明 |
|---|---|---|
| city(城市) | string | 可选 · 城市中文名(如「北京」「杭州」);与 id 二选一 · 示例:北京 |
| id | integer | 可选 · 城市 internal_id(可先调城市搜索);与 city 二选一 · 示例:33 |
可选 · 推荐: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_ 形态时生效)。匿名可不传,受每日免费额度限制。 |
城市信息:id / name / parent / pinyin / timezone
id
名称
brief
parent
pinyin
timezone
实况:温度、体感、湿度、气压、风力风向、紫外线、日出日落等
icon
condition
temperature
real_feel
humidity
pressure
wind_level
wind_dir
uvi
sun_rise
sun_set
lunar_date
dew_point
updatetime
tips
wind_speed
special_weather
wind_speeds
is_port
warn_icon
warn_title
warn_desc
warn_url
weather_push
空气质量指数与等级
value
level
description
updatetime
未来约 7 天逐日预报
condition_id_day
condition_id_night
condition_day
condition_night
temp_day
temp_night
icon_day
icon_night
wind_dir_day
wind_dir_night
sun_rise
sun_set
predict_date
wind_level_day
wind_level_night
wind_speed_day_real
wind_speed_night_real
lunar_date
aqi_desc_short
aqi_level
aqi_value
aqi_desc
uvi
humidity
未来约 24 小时逐时预报
condition
temperature
real_feel
humidity
wind_speed
wind_dir
wind_level
predict_hour
aqi_value
aqi_level
aqi_desc
comfort_tip
wind_text
comfort_tip_2
uvi_text
生活指数(穿衣、运动等)
名称
状态
level
地址
说明
extra
类型
气象预警列表
alert 的一项
一句话天气摘要
品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| city | object | 城市信息:id / name / parent / pinyin / timezone | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| condition | object | 实况:温度、体感、湿度、气压、风力风向、紫外线、日出日落等 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aqi | object | 空气质量指数与等级 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| forecast_day | array | 未来约 7 天逐日预报 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| forecast_hour | array | 未来约 24 小时逐时预报 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| index | array | 生活指数(穿衣、运动等) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| alert | array | 气象预警列表 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| summary | string | 一句话天气摘要 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · https://apizero.cn | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{
"code": 0,
"msg": "成功",
"data": {
"city": {
"id": 33,
"name": "北京市",
"brief": "北京市",
"parent": "北京市",
"pinyin": "beijingshi",
"timezone": 8
},
"condition": {
"icon": 31,
"condition": "多云",
"temperature": 27,
"real_feel": 30,
"humidity": 88,
"pressure": 999,
"wind_level": 3,
"wind_dir": "南风",
"uvi": "最弱",
"sun_rise": 1785445920000,
"sun_set": 1785497400000,
"lunar_date": "丙午年六月十八",
"dew_point": 23,
"updatetime": 1785441252000,
"tips": "今天有雨||今天有雨,略微偏热,注意衣物变化。",
"wind_speed": 3,
"special_weather": 1,
"wind_speeds": 3.69,
"is_port": 0,
"warn_icon": "",
"warn_title": "",
"warn_desc": "",
"warn_url": "",
"weather_push": "北京市,今天雷阵雨☔,24~32℃,西南风2级,空气 优,这两天空气都不错。雷雨天气,出行注意安全。",
"condition_id": 82,
"wind_direction_id": 9,
"weather_code": 2,
"bg_code": 2,
"warn_id": 0,
"comfort_id": 6
},
"aqi": {
"value": 36,
"level": 1,
"description": "优",
"updatetime": 1785438000000
},
"forecast_day": [
{
"condition_id_day": 4,
"condition_id_night": 31,
"condition_day": "雷阵雨",
"condition_night": "多云",
"temp_day": 33,
"temp_night": 26,
"icon_day": "3",
"icon_night": "3",
"wind_dir_day": "南风",
"wind_dir_night": "南风",
"sun_rise": 1785359460000,
"sun_set": 1785411060000,
"predict_date": 1785340830000,
"wind_level_day": 4,
"wind_level_night": 4,
"wind_speed_day_real": 4.4,
"wind_speed_night_real": 4.4,
"lunar_date": "丙午年六月十七",
"aqi_desc_short": "优",
"aqi_level": 1,
"aqi_value": 32,
"aqi_desc": "优",
"uvi": "中等",
"humidity": 61,
"pressure": 1003
},
{
"condition_id_day": 4,
"condition_id_night": 4,
"condition_day": "雷阵雨",
"condition_night": "雷阵雨",
"temp_day": 32,
"temp_night": 24,
"icon_day": "2",
"icon_night": "2",
"wind_dir_day": "南风",
"wind_dir_night": "西南风",
"sun_rise": 1785445920000,
"sun_set": 1785497400000,
"predict_date": 1785427230000,
"wind_level_day": 2,
"wind_level_night": 2,
"wind_speed_day_real": 2.4,
"wind_speed_night_real": 2.4,
"lunar_date": "丙午年六月十八",
"aqi_desc_short": "优",
"aqi_level": 1,
"aqi_value": 36,
"aqi_desc": "优",
"uvi": "弱",
"humidity": 75,
"pressure": 1002
},
{
"condition_id_day": 4,
"condition_id_night": 4,
"condition_day": "雷阵雨",
"condition_night": "雷阵雨",
"temp_day": 32,
"temp_night": 25,
"icon_day": "2",
"icon_night": "1",
"wind_dir_day": "南风",
"wind_dir_night": "东南风",
"sun_rise": 1785532380000,
"sun_set": 1785583740000,
"predict_date": 1785513630000,
"wind_level_day": 2,
"wind_level_night": 0,
"wind_speed_day_real": 2.4,
"wind_speed_night_real": 0.9,
"lunar_date": "丙午年六月十九",
"aqi_desc_short": "良",
"aqi_level": 2,
"aqi_value": 60,
"aqi_desc": "良",
"uvi": "弱",
"humidity": 77,
"pressure": 1001
}
],
"forecast_hour": [
{
"condition": "多云",
"temperature": 27,
"real_feel": 29,
"humidity": 88,
"wind_speed": "10.116",
"wind_dir": "南风",
"wind_level": "0",
"predict_hour": 1785438000000,
"aqi_value": 36,
"aqi_level": 1,
"aqi_desc": "优",
"comfort_tip": "潮湿",
"wind_text": "微风",
"comfort_tip_2": "适宜",
"uvi_text": "较低"
},
{
"condition": "多云",
"temperature": 27,
"real_feel": 29,
"humidity": 88,
"wind_speed": "13",
"wind_dir": "南风",
"wind_level": "0",
"predict_hour": 1785441600000,
"aqi_value": 38,
"aqi_level": 1,
"aqi_desc": "优",
"comfort_tip": "潮湿",
"wind_text": "微风",
"comfort_tip_2": "适宜",
"uvi_text": "较低"
},
{
"condition": "多云",
"temperature": 26,
"real_feel": 29,
"humidity": 89,
"wind_speed": "7.2",
"wind_dir": "南风",
"wind_level": "0",
"predict_hour": 1785445200000,
"aqi_value": 41,
"aqi_level": 1,
"aqi_desc": "优",
"comfort_tip": "潮湿",
"wind_text": "微风",
"comfort_tip_2": "适宜",
"uvi_text": "较低"
}
],
"index": [
{
"name": "限行",
"status": "尾号",
"level": 1,
"url": "$1/?indexid=1&cityid=33&appshare=1",
"desc": "",
"extra": "5, 0",
"type": 0
},
{
"name": "六月十八",
"status": "万年历",
"level": 2,
"url": "https://html5.moji.com/nb/wnlh5/index.html?channel=speed",
"desc": "$0/index/lunar_v6.png",
"extra": "",
"type": 0
},
{
"name": "闷热",
"status": "穿衣",
"level": 20,
"url": "$1/?indexid=20&cityid=33&appshare=1",
"desc": "$0/index/dress_v6.png",
"extra": "潮湿闷热,衣物排汗透气,手帕擦汗环保时尚,不建议在露天场所逛街。",
"type": 2
}
],
"alert": [],
"updatetime": 1785443154731,
"summary": "北京市,多云,27℃,南风3级,空气优。",
"_cached": true,
"_disclaimer": "数据由墨迹天气提供,仅供参考,不构成专业气象建议;不应用于农业、保险、航运、防灾等决策场景。详细免责声明见 marketplace 详情页。"
},
"request_id": "ms7yrw773bba2d1a",
"tips": "极数本源 · https://apizero.cn"
}