彩云天气

weatherGET
GEThttps://v1.apizero.cn/api/weather
获取 API Key工作台购买 / 调试

概述

全功能天气接口，覆盖： • 实时天气（温度/湿度/风/能见度/AQI/PM2.5） • 分钟级降水预报（未来 2 小时） • 小时预报（最长 360 小时 = 15 天） • 天预报（最长 15 天，含日出日落、温度极值、生活指数） • 综合数据（一次返回全部 + 气象预警） 特色： • 支持城市名直接查询（内置常用中国城市，也支持经纬度） • 自动中文化：skycon 转中文、风向转 16 方位、风速转蒲福风级、AQI 转等级颜色 • 预警标准化：从原始 title 提取颜色（蓝/黄/橙/红）和级别（一般/较重/严重/特别严重） • 顶层 summary 字段提供"一眼看懂"的实时摘要 • 对齐官网风级请读 summary.wind.level_si（speed_ms / level 为历史字段，数字不改）

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/weather/raw.md
打开 Markdown

鉴权

未携带 API Key：每天 5 次 · QPS 2；已登录（未开通会员）：每天 20 次 · QPS 3；试用：一次性 5 次；黄金会员：每天 50,000 次 · QPS 10；钻石会员：每天 100,000 次 · QPS 30；企业会员：每天 1,000,000 次 · QPS 60；点数：本接口不支持扣点；免费。

获取 API Key

请求头

Authorizationstring选填

推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

综合天气（推荐）

GETURL QUERY·APPLICATION/JSON

一次返回实时 + 分钟降水 + 小时/天预报 + 气象预警摘要。type 默认 weather。city 与 location 二选一。文档示例为北京真实数据（预报序列已截断）。summary.wind.speed_ms / level 是历史字段（数字=官方 km/h，风级按旧算法）；对齐官网请读 speed_si_ms / level_si / level_si_text。realtime.wind.speed 默认单位是 km/h，不是 m/s。

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（类型）string选填

固定为 weather：综合数据包

例weather

city（城市）string选填

城市/地区名称，与 location 二选一

例北京

location（经纬度）string选填

经纬度「经度,纬度」，优先级高于 city

例116.3975,39.9085

alert（预警）boolean选填

是否附带气象预警

例true

days（天数）integer选填

天预报天数 1–15。可继续传 1，返回仍按这个天数裁

例7

hours（小时数）integer选填

小时预报小时数 1–360。可继续传 1 或 12，返回仍按这个小时数裁

例48

返回结果

typestring

查询类型，此处为 weather

locationobject

城市、经纬度、时区

citystring

城市或地区名

longitudenumber

经度，十进制度

latitudenumber

纬度，十进制度

timezonestring

时区，IANA 名称，如 Asia/Shanghai

server_timestring

服务端时间，北京时间，格式 YYYY-MM-DD HH:mm:ss

forecast_keypointstring

一句话天气总结，直接给界面展示

summaryobject

一眼可读的实时摘要。温度、湿度、云量这里已经换成常用单位，风级对齐官网看 level_si

citystring

摘要里的城市名

skyconstring

天气现象中文，如多云、小雨。代码在 skycon_code

skycon_emojistring

天气现象对应的表情，如 ☁️

skycon_codestring

天气现象代码，如 PARTLY_CLOUDY_NIGHT，与 realtime.skycon 相同

temperaturenumber

气温，℃，可直接展示

apparent_temperaturenumber

体感温度，℃

humidity_percentnumber

相对湿度百分数。81 表示 81%。原始 0–1 在 realtime.humidity

cloudrate_percentnumber

云量百分数。29 表示 29%。原始 0–1 在 realtime.cloudrate

visibility_kmnumber

能见度，km

windobject

风的摘要。speed_ms / level 是历史字段；对齐彩云官网用 speed_si_ms、level_si、level_si_text

speed_msnumber

历史字段，数字就是彩云默认公制风速（km/h），不是米/秒。已对接的不用改

direction_degnumber

风向角度，从正北起顺时针，0–360

direction_textstring

风向中文，如西南偏南风

levelnumber

历史蒲福风级（旧算法）。对齐官网请改读 level_si

level_textstring

历史风级的中文，如和风。对齐官网请改读 level_si_text

speed_si_msnumber

真正的米/秒，由官方 km/h 除以 3.6

level_sinumber

按米/秒算出的蒲福风级，和彩云官网一致

level_si_textstring

和官网一致的风级中文，如轻风

air_qualityobject

空气质量摘要，数值按国标

aqinumber

国标 AQI

levelstring

空气质量等级，如优、良

level_colorstring

等级配色，如 green，给界面上色

pm25number

PM2.5 浓度，μg/m³

alert_countinteger

当前气象预警条数。0 表示没有预警

alertsarray

气象预警列表

alerts[]string

一条气象预警原文。没有预警时，这个数组是空的

realtimeobject

实时天气原始字段

statusstring

这一段数据的状态，ok 表示成功

temperaturenumber

地表 2 米气温，℃

humiditynumber

地表 2 米相对湿度，0–1。0.81 即 81%，不是百分数

cloudratenumber

总云量，0–1。0.29 大约是三成云

skyconstring

天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

visibilitynumber

地表水平能见度，km

dswrfnumber

向下短波辐射通量，W/m²。夜里通常是 0

windobject

地表 10 米风。speed 是风速，默认公制 km/h，不是 m/s；direction 是从正北顺时针的角度

speednumber

风速。默认公制是 km/h，不是 m/s

directionnumber

风向角度，从正北起顺时针，0–360

pressurenumber

地面气压，Pa

apparent_temperaturenumber

体感温度，℃

precipitationobject

降水实况，分本地 local 和最近降水带 nearest

localobject

本地降水。datasource 在雷达覆盖区为 radar；intensity 默认公制是雷达强度 0–1，不是 mm/h

nearestobject

最近一块降水，只有雷达覆盖区才有。distance 是距离（km），intensity 和本地强度同一套单位

air_qualityobject

空气质量

pm25number

PM2.5 浓度，μg/m³

pm10number

PM10 浓度，μg/m³

o3number

臭氧浓度，μg/m³

so2number

二氧化硫浓度，μg/m³

no2number

二氧化氮浓度，μg/m³

conumber

一氧化碳浓度，mg/m³

aqiobject

空气质量指数。chn 是国标，usa 是美标

descriptionobject

空气质量等级文字。chn 是国标，usa 是美标，如优、良

life_indexobject

生活指数

ultravioletobject

紫外线。index 是等级，desc 是中文，如无、最弱、弱

comfortobject

舒适度。index 是等级，desc 是中文，如闷热、湿冷

minutelyobject

分钟级降水（仅综合包）

statusstring

这一段数据的状态，ok 表示成功

datasourcestring

数据来源。雷达覆盖区为 radar

precipitation_2harray

未来 2 小时逐分钟降水强度，完整 120 个点（文档示例已截断）。默认公制是雷达强度 0–1，不是 mm/h

minutely.precipitation_2h[]number

未来 2 小时里某一分钟的降水强度。默认公制是雷达强度 0–1，不是 mm/h

precipitationarray

未来 1 小时逐分钟降水强度，就是 precipitation_2h 的前 60 个点。默认公制是雷达强度 0–1

minutely.precipitation[]number

未来 1 小时里某一分钟的降水强度，单位和 precipitation_2h 相同

accumulationarray

未来 2 小时按小时累计的降水量，单位 mm，两项分别是第 1、第 2 小时。不要拿它和逐分钟强度互推

minutely.accumulation[]number

某一小时的累计降水量，毫米。两项依次是未来第 1 小时、第 2 小时

probabilityarray

未来 2 小时的降水概率，共 4 个数，范围 0–1。依次对应 0–30、30–60、60–90、90–120 分钟

minutely.probability[]number

一个时段的降水概率，范围 0–1。四项依次是未来 0–30、30–60、60–90、90–120 分钟

descriptionstring

未来 2 小时会不会下雨的一句话

hourlyobject

小时预报

statusstring

这一段数据的状态，ok 表示成功

descriptionstring

接下来天气怎么变的一句话，例如几点转雨

precipitationarray

逐小时降水。value 是强度（默认公制 mm/h），probability 是概率 0–100

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时降水强度。默认公制是 mm/h

probabilitynumber

降水概率，0–100，单位是百分数

temperaturearray

逐小时地表 2 米气温，℃

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时气温，℃

apparent_temperaturearray

逐小时体感温度，℃

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时体感温度，℃

windarray

逐小时地表 10 米风。speed 是风速，默认公制 km/h，不是 m/s；direction 是从正北顺时针的角度

datetimestring

这条记录的时刻，ISO8601，带时区

speednumber

风速。默认公制是 km/h，不是 m/s

directionnumber

风向角度，从正北起顺时针，0–360

humidityarray

逐小时相对湿度，0–1。0.81 即 81%，不是百分数

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时相对湿度，0–1（0.81 即 81%，不是百分数）

cloudratearray

逐小时总云量，0–1。0.29 大约是三成云

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时云量，0–1

skyconarray

逐小时天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

datetimestring

这条记录的时刻，ISO8601，带时区

valuestring

该时刻的天气现象代码，取值见 skycon

pressurearray

逐小时地面气压，Pa

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时地面气压，Pa

visibilityarray

逐小时水平能见度，km

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时水平能见度，km

dswrfarray

逐小时向下短波辐射通量，W/m²。夜里通常是 0

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时向下短波辐射通量，W/m²

air_qualityobject

空气质量

aqiarray

逐小时空气质量指数。value 里 chn 是国标，usa 是美标

pm25array

逐小时 PM2.5 浓度，μg/m³

dailyobject

天预报

statusstring

这一段数据的状态，ok 表示成功

astroarray

日出和日落，时刻是当地时间

datestring

这一天的 0 点，ISO8601，带时区

sunriseobject

日出。time 是当地时间，如 05:11

sunsetobject

日落。time 是当地时间，如 19:29

precipitation_08h_20harray

白天 08–20 时的降水。强度默认公制 mm/h，probability 是概率 0–100

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

白天 08–20 时最大降水强度。默认公制是 mm/h

minnumber

白天 08–20 时最小降水强度。默认公制是 mm/h

avgnumber

白天 08–20 时平均降水强度。默认公制是 mm/h。这是完整 12 小时的平均

probabilitynumber

降水概率，0–100，单位是百分数

precipitation_20h_32harray

夜晚 20 时到次日 08 时的降水。强度默认公制 mm/h，probability 是概率 0–100

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

夜晚 20 时到次日 08 时最大降水强度。默认公制是 mm/h

minnumber

夜晚 20 时到次日 08 时最小降水强度。默认公制是 mm/h

avgnumber

夜晚 20 时到次日 08 时平均降水强度。默认公制是 mm/h。这是完整 12 小时的平均

probabilitynumber

降水概率，0–100，单位是百分数

precipitationarray

全天降水。强度默认公制是 mm/h，probability 是概率 0–100

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大降水强度。默认公制是 mm/h

minnumber

全天最小降水强度。默认公制是 mm/h

avgnumber

全天平均降水强度。默认公制是 mm/h。当天的平均值从当前整点算到日终，不是 24 小时平均

probabilitynumber

降水概率，0–100，单位是百分数

temperaturearray

全天（0–24 时）地表 2 米气温，℃

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最高气温，℃

minnumber

全天最低气温，℃

avgnumber

全天平均气温，℃。当天的平均值从当前整点算到日终，不是 24 小时平均

temperature_08h_20harray

白天 08–20 时的气温，℃

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

白天 08–20 时最高气温，℃

minnumber

白天 08–20 时最低气温，℃

avgnumber

白天 08–20 时平均气温，℃。这是完整 12 小时的平均

temperature_20h_32harray

夜晚 20 时到次日 08 时的气温，℃

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

夜晚 20 时到次日 08 时最高气温，℃

minnumber

夜晚 20 时到次日 08 时最低气温，℃

avgnumber

夜晚 20 时到次日 08 时平均气温，℃。这是完整 12 小时的平均

windarray

全天地表 10 米风。max / min / avg 里都有 speed（风速，默认 km/h）和 direction（风向角）

datestring

这一天的 0 点，ISO8601，带时区

maxobject

全天最大风，里面 speed 是风速（km/h），direction 是当时的风向角

minobject

全天最小风，里面 speed 是风速（km/h），direction 是当时的风向角

avgobject

全天平均风，里面 speed 是风速（km/h），direction 是当时的风向角。全天风的平均固定按 24 小时算，不像气温那样从当前整点截断

wind_08h_20harray

白天 08–20 时地表 10 米风。max / min / avg 里都有 speed（风速，默认 km/h）和 direction（风向角）

datestring

这一天的 0 点，ISO8601，带时区

maxobject

白天 08–20 时最大风，里面 speed 是风速（km/h），direction 是当时的风向角

minobject

白天 08–20 时最小风，里面 speed 是风速（km/h），direction 是当时的风向角

avgobject

白天 08–20 时平均风，里面 speed 是风速（km/h），direction 是当时的风向角。这是完整 12 小时的平均

wind_20h_32harray

夜晚 20 时到次日 08 时地表 10 米风。max / min / avg 里都有 speed（风速，默认 km/h）和 direction（风向角）

datestring

这一天的 0 点，ISO8601，带时区

maxobject

夜晚 20 时到次日 08 时最大风，里面 speed 是风速（km/h），direction 是当时的风向角

minobject

夜晚 20 时到次日 08 时最小风，里面 speed 是风速（km/h），direction 是当时的风向角

avgobject

夜晚 20 时到次日 08 时平均风，里面 speed 是风速（km/h），direction 是当时的风向角。这是完整 12 小时的平均

humidityarray

全天相对湿度，0–1。0.81 即 81%，不是百分数

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大相对湿度，0–1（0.81 即 81%，不是百分数）

minnumber

全天最小相对湿度，0–1（0.81 即 81%，不是百分数）

avgnumber

全天平均相对湿度，0–1（0.81 即 81%，不是百分数）。当天的平均值从当前整点算到日终，不是 24 小时平均

cloudratearray

全天总云量，0–1。0.29 大约是三成云

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大云量，0–1

minnumber

全天最小云量，0–1

avgnumber

全天平均云量，0–1。当天的平均值从当前整点算到日终，不是 24 小时平均

pressurearray

全天地面气压，Pa

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大地面气压，Pa

minnumber

全天最小地面气压，Pa

avgnumber

全天平均地面气压，Pa。当天的平均值从当前整点算到日终，不是 24 小时平均

visibilityarray

全天水平能见度，km

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大水平能见度，km

minnumber

全天最小水平能见度，km

avgnumber

全天平均水平能见度，km。当天的平均值从当前整点算到日终，不是 24 小时平均

dswrfarray

全天向下短波辐射通量，W/m²。夜里通常是 0

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大向下短波辐射通量，W/m²

minnumber

全天最小向下短波辐射通量，W/m²

avgnumber

全天平均向下短波辐射通量，W/m²。当天的平均值从当前整点算到日终，不是 24 小时平均

air_qualityobject

空气质量

aqiarray

逐日空气质量指数。max / avg / min 里都有国标 chn 和美标 usa

pm25array

逐日 PM2.5 浓度，μg/m³。每天有最大、平均、最小

skyconarray

全天主要天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

datestring

这一天的 0 点，ISO8601，带时区

valuestring

该时刻的天气现象代码，取值见 skycon

skycon_08h_20harray

白天 08–20 时的主要天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

datestring

这一天的 0 点，ISO8601，带时区

valuestring

该时刻的天气现象代码，取值见 skycon

skycon_20h_32harray

夜晚 20 时到次日 08 时的主要天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

datestring

这一天的 0 点，ISO8601，带时区

valuestring

该时刻的天气现象代码，取值见 skycon

life_indexobject

生活指数

ultravioletarray

逐日紫外线。每项有日期、等级 index 和中文 desc（如最弱、弱）

carWashingarray

洗车指数。每项有日期、等级 index 和中文 desc（如较不适宜）

dressingarray

穿衣指数。每项有日期、等级 index 和中文 desc（如很热）

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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"
}

实时天气

GETURL QUERY·APPLICATION/JSON

仅返回 realtime：温度、湿度、风、能见度、AQI、PM2.5 等即时数据。示例为北京真实抓取。realtime.wind.speed 默认是 km/h；对齐官网风级读 summary.wind.level_si。

https://v1.apizero.cn/api/weather?type=realtime&city=%E5%8C%97%E4%BA%AC&location=116.3975%2C39.9085

type（类型）string必填

固定为 realtime

例realtime

city（城市）string选填

城市名，与 location 二选一

例北京

location（经纬度）string选填

经纬度坐标

例116.3975,39.9085

返回结果

typestring

realtime

locationobject

定位信息

citystring

城市或地区名

longitudenumber

经度，十进制度

latitudenumber

纬度，十进制度

timezonestring

时区，IANA 名称，如 Asia/Shanghai

summaryobject

中文化摘要。对齐官网风级用 wind.level_si

citystring

城市

skyconstring

天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

skycon_emojistring

skycon_emoji

skycon_codestring

skycon_code

temperaturenumber

地表 2 米气温，℃

apparent_temperaturenumber

体感温度，℃

humidity_percentnumber

humidity_percent

cloudrate_percentnumber

cloudrate_percent

visibility_kmnumber

visibility_km

windobject

地表 10 米风。speed 是风速，默认公制 km/h，不是 m/s；direction 是从正北顺时针的角度

speed_msnumber

speed_ms

direction_degnumber

direction_deg

direction_textstring

direction_text

levelnumber

level

level_textstring

level_text

air_qualityobject

空气质量

aqinumber

空气质量指数。chn 是国标，usa 是美标

levelstring

level

level_colorstring

level_color

pm25number

PM2.5 浓度，μg/m³

alert_countnumber

alert_count

realtimeobject

实时气象字段。wind.speed 默认单位 km/h，不是 m/s

statusstring

这一段数据的状态，ok 表示成功

temperaturenumber

地表 2 米气温，℃

humiditynumber

地表 2 米相对湿度，0–1。0.81 即 81%，不是百分数

cloudratenumber

总云量，0–1。0.29 大约是三成云

skyconstring

天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

visibilitynumber

地表水平能见度，km

dswrfnumber

向下短波辐射通量，W/m²。夜里通常是 0

windobject

地表 10 米风。speed 是风速，默认公制 km/h，不是 m/s；direction 是从正北顺时针的角度

speednumber

风速。默认公制是 km/h，不是 m/s

directionnumber

风向角度，从正北起顺时针，0–360

pressurenumber

地面气压，Pa

apparent_temperaturenumber

体感温度，℃

precipitationobject

降水实况，分本地 local 和最近降水带 nearest

localobject

本地降水。datasource 在雷达覆盖区为 radar；intensity 默认公制是雷达强度 0–1，不是 mm/h

nearestobject

最近一块降水，只有雷达覆盖区才有。distance 是距离（km），intensity 和本地强度同一套单位

air_qualityobject

空气质量

pm25number

PM2.5 浓度，μg/m³

pm10number

PM10 浓度，μg/m³

o3number

臭氧浓度，μg/m³

so2number

二氧化硫浓度，μg/m³

no2number

二氧化氮浓度，μg/m³

conumber

一氧化碳浓度，mg/m³

aqiobject

空气质量指数。chn 是国标，usa 是美标

descriptionobject

空气质量等级文字。chn 是国标，usa 是美标，如优、良

life_indexobject

生活指数

ultravioletobject

紫外线。index 是等级，desc 是中文，如无、最弱、弱

comfortobject

舒适度。index 是等级，desc 是中文，如闷热、湿冷

alertsarray

气象预警（若有）

alerts[]string

一条气象预警原文。没有预警时，这个数组是空的

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "type": "realtime",
    "location": {
      "city": "北京",
      "longitude": 116.4074,
      "latitude": 39.9042,
      "timezone": "Asia/Shanghai"
    },
    "server_time": "2026-07-31 04:10:38",
    "forecast_keypoint": null,
    "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": "闷热"
        }
      }
    }
  },
  "request_id": "ms7y7k4m10fef03e",
  "tips": "极数本源 · https://apizero.cn"
}

分钟级降水

GETURL QUERY·APPLICATION/JSON

未来约 2 小时分钟级降水强度预报，适合短时出行决策。示例为北京真实抓取。

https://v1.apizero.cn/api/weather?type=minutely&city=%E5%8C%97%E4%BA%AC&location=116.3975%2C39.9085

type（类型）string必填

固定为 minutely

例minutely

city（城市）string选填

城市名

例北京

location（经纬度）string选填

经纬度

例116.3975,39.9085

返回结果

typestring

minutely

forecast_keypointstring

短时降水一句话提示

minutelyobject

分钟降水序列与描述文案

statusstring

这一段数据的状态，ok 表示成功

datasourcestring

数据来源。雷达覆盖区为 radar

precipitation_2harray

未来 2 小时逐分钟降水强度，完整 120 个点（文档示例已截断）。默认公制是雷达强度 0–1，不是 mm/h

minutely.precipitation_2h[]number

未来 2 小时里某一分钟的降水强度。默认公制是雷达强度 0–1，不是 mm/h

precipitationarray

未来 1 小时逐分钟降水强度，就是 precipitation_2h 的前 60 个点。默认公制是雷达强度 0–1

minutely.precipitation[]number

未来 1 小时里某一分钟的降水强度，单位和 precipitation_2h 相同

accumulationarray

未来 2 小时按小时累计的降水量，单位 mm，两项分别是第 1、第 2 小时。不要拿它和逐分钟强度互推

minutely.accumulation[]number

某一小时的累计降水量，毫米。两项依次是未来第 1 小时、第 2 小时

probabilityarray

未来 2 小时的降水概率，共 4 个数，范围 0–1。依次对应 0–30、30–60、60–90、90–120 分钟

minutely.probability[]number

一个时段的降水概率，范围 0–1。四项依次是未来 0–30、30–60、60–90、90–120 分钟

descriptionstring

未来 2 小时会不会下雨的一句话

summaryobject

实时摘要（若有）

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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"
}

小时预报

GETURL QUERY·APPLICATION/JSON

最长 360 小时（15 天）逐小时预报。可用 hours 控制返回长度。示例为北京真实抓取（序列已截断）。

https://v1.apizero.cn/api/weather?type=hourly&city=%E5%8C%97%E4%BA%AC&hours=6

type（类型）string必填

固定为 hourly

例hourly

city（城市）string选填

城市名

例北京

hours（小时数）integer选填

返回小时数，1–360

例6

返回结果

typestring

hourly

locationobject

定位信息

citystring

城市或地区名

longitudenumber

经度，十进制度

latitudenumber

纬度，十进制度

timezonestring

时区，IANA 名称，如 Asia/Shanghai

hourlyobject

逐小时温度、降水、天气现象等

statusstring

这一段数据的状态，ok 表示成功

descriptionstring

接下来天气怎么变的一句话，例如几点转雨

precipitationarray

逐小时降水。value 是强度（默认公制 mm/h），probability 是概率 0–100

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时降水强度。默认公制是 mm/h

probabilitynumber

降水概率，0–100，单位是百分数

temperaturearray

逐小时地表 2 米气温，℃

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时气温，℃

apparent_temperaturearray

逐小时体感温度，℃

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时体感温度，℃

windarray

逐小时地表 10 米风。speed 是风速，默认公制 km/h，不是 m/s；direction 是从正北顺时针的角度

datetimestring

这条记录的时刻，ISO8601，带时区

speednumber

风速。默认公制是 km/h，不是 m/s

directionnumber

风向角度，从正北起顺时针，0–360

humidityarray

逐小时相对湿度，0–1。0.81 即 81%，不是百分数

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时相对湿度，0–1（0.81 即 81%，不是百分数）

cloudratearray

逐小时总云量，0–1。0.29 大约是三成云

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时云量，0–1

skyconarray

逐小时天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

datetimestring

这条记录的时刻，ISO8601，带时区

valuestring

该时刻的天气现象代码，取值见 skycon

pressurearray

逐小时地面气压，Pa

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时地面气压，Pa

visibilityarray

逐小时水平能见度，km

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时水平能见度，km

dswrfarray

逐小时向下短波辐射通量，W/m²。夜里通常是 0

datetimestring

这条记录的时刻，ISO8601，带时区

valuenumber

该小时向下短波辐射通量，W/m²

air_qualityobject

空气质量

aqiarray

逐小时空气质量指数。value 里 chn 是国标，usa 是美标

pm25array

逐小时 PM2.5 浓度，μg/m³

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "type": "hourly",
    "location": {
      "city": "北京",
      "longitude": 116.4074,
      "latitude": 39.9042,
      "timezone": "Asia/Shanghai"
    },
    "server_time": "2026-07-31 04:10:15",
    "forecast_keypoint": "多云，今天晚间23点钟后转小雨，其后多云",
    "summary": null,
    "alerts": [],
    "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.38
        },
        {
          "datetime": "2026-07-31T06:00+08:00",
          "value": 28.19
        }
      ],
      "apparent_temperature": [
        {
          "datetime": "2026-07-31T04:00+08:00",
          "value": 32.6
        },
        {
          "datetime": "2026-07-31T05:00+08:00",
          "value": 32.4
        },
        {
          "datetime": "2026-07-31T06:00+08:00",
          "value": 32.3
        },
        {
          "datetime": "2026-07-31T07:00+08:00",
          "value": 32
        },
        {
          "datetime": "2026-07-31T08:00+08:00",
          "value": 31.9
        },
        {
          "datetime": "2026-07-31T09:00+08:00",
          "value": 32.3
        }
      ],
      "wind": [
        {
          "datetime": "2026-07-31T04:00+08:00",
          "speed": 5.3,
          "direction": 191.77
        },
        {
          "datetime": "2026-07-31T05:00+08:00",
          "speed": 5.36,
          "direction": 185.79
        },
        {
          "datetime": "2026-07-31T06:00+08:00",
          "speed": 4.26,
          "direction": 175.64
        }
      ],
      "humidity": [
        {
          "datetime": "2026-07-31T04:00+08:00",
          "value": 0.81
        },
        {
          "datetime": "2026-07-31T05:00+08:00",
          "value": 0.85
        },
        {
          "datetime": "2026-07-31T06:00+08:00",
          "value": 0.85
        }
      ],
      "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": 99614.5
        },
        {
          "datetime": "2026-07-31T05:00+08:00",
          "value": 99631.5
        },
        {
          "datetime": "2026-07-31T06:00+08:00",
          "value": 99639.94
        }
      ],
      "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": 46,
              "usa": 69
            }
          },
          {
            "datetime": "2026-07-31T05:00+08:00",
            "value": {
              "chn": 46,
              "usa": 71
            }
          }
        ],
        "pm25": [
          {
            "datetime": "2026-07-31T04:00+08:00",
            "value": 21
          },
          {
            "datetime": "2026-07-31T05:00+08:00",
            "value": 22
          }
        ]
      }
    }
  },
  "request_id": "ms7y7s5z4b78404d",
  "tips": "极数本源 · https://apizero.cn"
}

天预报

GETURL QUERY·APPLICATION/JSON

最长 15 天逐日预报，含温度极值、日出日落、生活指数等。示例为北京真实抓取（序列已截断）。

https://v1.apizero.cn/api/weather?type=daily&city=%E5%8C%97%E4%BA%AC&days=3

type（类型）string必填

固定为 daily

例daily

city（城市）string选填

城市名

例北京

days（天数）integer选填

预报天数 1–15

例3

返回结果

typestring

daily

locationobject

定位信息

citystring

城市或地区名

longitudenumber

经度，十进制度

latitudenumber

纬度，十进制度

timezonestring

时区，IANA 名称，如 Asia/Shanghai

dailyobject

逐日温度、天气、生活指数等

statusstring

这一段数据的状态，ok 表示成功

astroarray

日出和日落，时刻是当地时间

datestring

这一天的 0 点，ISO8601，带时区

sunriseobject

日出。time 是当地时间，如 05:11

sunsetobject

日落。time 是当地时间，如 19:29

precipitation_08h_20harray

白天 08–20 时的降水。强度默认公制 mm/h，probability 是概率 0–100

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

白天 08–20 时最大降水强度。默认公制是 mm/h

minnumber

白天 08–20 时最小降水强度。默认公制是 mm/h

avgnumber

白天 08–20 时平均降水强度。默认公制是 mm/h。这是完整 12 小时的平均

probabilitynumber

降水概率，0–100，单位是百分数

precipitation_20h_32harray

夜晚 20 时到次日 08 时的降水。强度默认公制 mm/h，probability 是概率 0–100

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

夜晚 20 时到次日 08 时最大降水强度。默认公制是 mm/h

minnumber

夜晚 20 时到次日 08 时最小降水强度。默认公制是 mm/h

avgnumber

夜晚 20 时到次日 08 时平均降水强度。默认公制是 mm/h。这是完整 12 小时的平均

probabilitynumber

降水概率，0–100，单位是百分数

precipitationarray

全天降水。强度默认公制是 mm/h，probability 是概率 0–100

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大降水强度。默认公制是 mm/h

minnumber

全天最小降水强度。默认公制是 mm/h

avgnumber

全天平均降水强度。默认公制是 mm/h。当天的平均值从当前整点算到日终，不是 24 小时平均

probabilitynumber

降水概率，0–100，单位是百分数

temperaturearray

全天（0–24 时）地表 2 米气温，℃

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最高气温，℃

minnumber

全天最低气温，℃

avgnumber

全天平均气温，℃。当天的平均值从当前整点算到日终，不是 24 小时平均

temperature_08h_20harray

白天 08–20 时的气温，℃

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

白天 08–20 时最高气温，℃

minnumber

白天 08–20 时最低气温，℃

avgnumber

白天 08–20 时平均气温，℃。这是完整 12 小时的平均

temperature_20h_32harray

夜晚 20 时到次日 08 时的气温，℃

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

夜晚 20 时到次日 08 时最高气温，℃

minnumber

夜晚 20 时到次日 08 时最低气温，℃

avgnumber

夜晚 20 时到次日 08 时平均气温，℃。这是完整 12 小时的平均

windarray

全天地表 10 米风。max / min / avg 里都有 speed（风速，默认 km/h）和 direction（风向角）

datestring

这一天的 0 点，ISO8601，带时区

maxobject

全天最大风，里面 speed 是风速（km/h），direction 是当时的风向角

minobject

全天最小风，里面 speed 是风速（km/h），direction 是当时的风向角

avgobject

全天平均风，里面 speed 是风速（km/h），direction 是当时的风向角。全天风的平均固定按 24 小时算，不像气温那样从当前整点截断

wind_08h_20harray

白天 08–20 时地表 10 米风。max / min / avg 里都有 speed（风速，默认 km/h）和 direction（风向角）

datestring

这一天的 0 点，ISO8601，带时区

maxobject

白天 08–20 时最大风，里面 speed 是风速（km/h），direction 是当时的风向角

minobject

白天 08–20 时最小风，里面 speed 是风速（km/h），direction 是当时的风向角

avgobject

白天 08–20 时平均风，里面 speed 是风速（km/h），direction 是当时的风向角。这是完整 12 小时的平均

wind_20h_32harray

夜晚 20 时到次日 08 时地表 10 米风。max / min / avg 里都有 speed（风速，默认 km/h）和 direction（风向角）

datestring

这一天的 0 点，ISO8601，带时区

maxobject

夜晚 20 时到次日 08 时最大风，里面 speed 是风速（km/h），direction 是当时的风向角

minobject

夜晚 20 时到次日 08 时最小风，里面 speed 是风速（km/h），direction 是当时的风向角

avgobject

夜晚 20 时到次日 08 时平均风，里面 speed 是风速（km/h），direction 是当时的风向角。这是完整 12 小时的平均

humidityarray

全天相对湿度，0–1。0.81 即 81%，不是百分数

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大相对湿度，0–1（0.81 即 81%，不是百分数）

minnumber

全天最小相对湿度，0–1（0.81 即 81%，不是百分数）

avgnumber

全天平均相对湿度，0–1（0.81 即 81%，不是百分数）。当天的平均值从当前整点算到日终，不是 24 小时平均

cloudratearray

全天总云量，0–1。0.29 大约是三成云

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大云量，0–1

minnumber

全天最小云量，0–1

avgnumber

全天平均云量，0–1。当天的平均值从当前整点算到日终，不是 24 小时平均

pressurearray

全天地面气压，Pa

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大地面气压，Pa

minnumber

全天最小地面气压，Pa

avgnumber

全天平均地面气压，Pa。当天的平均值从当前整点算到日终，不是 24 小时平均

visibilityarray

全天水平能见度，km

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大水平能见度，km

minnumber

全天最小水平能见度，km

avgnumber

全天平均水平能见度，km。当天的平均值从当前整点算到日终，不是 24 小时平均

dswrfarray

全天向下短波辐射通量，W/m²。夜里通常是 0

datestring

这一天的 0 点，ISO8601，带时区

maxnumber

全天最大向下短波辐射通量，W/m²

minnumber

全天最小向下短波辐射通量，W/m²

avgnumber

全天平均向下短波辐射通量，W/m²。当天的平均值从当前整点算到日终，不是 24 小时平均

air_qualityobject

空气质量

aqiarray

逐日空气质量指数。max / avg / min 里都有国标 chn 和美标 usa

pm25array

逐日 PM2.5 浓度，μg/m³。每天有最大、平均、最小

skyconarray

全天主要天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

datestring

这一天的 0 点，ISO8601，带时区

valuestring

该时刻的天气现象代码，取值见 skycon

skycon_08h_20harray

白天 08–20 时的主要天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

datestring

这一天的 0 点，ISO8601，带时区

valuestring

该时刻的天气现象代码，取值见 skycon

skycon_20h_32harray

夜晚 20 时到次日 08 时的主要天气现象代码。如 CLEAR_DAY 晴、PARTLY_CLOUDY_NIGHT 夜间多云、CLOUDY 阴、LIGHT_RAIN 小雨、MODERATE_RAIN 中雨、HEAVY_RAIN 大雨、LIGHT_SNOW 小雪、FOG 雾

datestring

这一天的 0 点，ISO8601，带时区

valuestring

该时刻的天气现象代码，取值见 skycon

life_indexobject

生活指数

ultravioletarray

逐日紫外线。每项有日期、等级 index 和中文 desc（如最弱、弱）

carWashingarray

洗车指数。每项有日期、等级 index 和中文 desc（如较不适宜）

dressingarray

穿衣指数。每项有日期、等级 index 和中文 desc（如很热）

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "type": "daily",
    "location": {
      "city": "北京",
      "longitude": 116.4074,
      "latitude": 39.9042,
      "timezone": "Asia/Shanghai"
    },
    "server_time": "2026-07-31 04:10:49",
    "forecast_keypoint": null,
    "summary": null,
    "alerts": [],
    "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": 48,
              "usa": 78
            },
            "min": {
              "chn": 37,
              "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": 17
          },
          {
            "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": "ms7y7sqff6490a75",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/weather"

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
完全免费
QPS 限制
QPS 3
登录免费额度
20 次（已认证）
匿名每日额度
5 次（无 API Key）
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 60

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.0.02026-05-06

    首次发布：5 种 type（realtime/minutely/hourly/daily/weather）+ 城市名直查 内置 ~140 个常用城市经纬度表 + Open-Meteo Geocoding 兜底（不依赖高德/百度 Key） 顶层 summary 实时摘要：skycon 中文化、风向 16 方位、风级蒲福分级、AQI 等级颜色 预警 alerts 标准化：自动提取颜色（蓝/黄/橙/红）和级别（一般/较重/严重/特别严重）

彩云天气 接入文档｜极数本源