天气 API
  1. 天气接口目录
天气 API
  • 气象预警
    • 全国城市气象预警推送服务
    • 气象预警推送
      POST
    • 解除气象预警推送 - 服务端对接文档
      POST
  • 天气接口目录
    • 专业实况天气接口v61
      GET
    • 专业实况天气接口v62
      GET
    • 专业实况天气接口v63
      GET
    • 专业七日天气接口v9
      GET
    • 专业七日天气接口v91
      GET
    • 专业七日天气接口v93
      GET
    • 1~40日天气接口v3
      GET
    • 1~40日天气接口v31
      GET
    • 实况+24小时+15日天气接口 v32
      GET
    • 国外主要城市7日天气接口
      GET
    • 全球20万+城市实况天气
      GET
    • 实时降水, 降雨量接口
      GET
    • 过去24小时+未来3天小时降雨量接口
      GET
    • 天气灾害预警气象预警列表接口
      GET
    • 新版历史天气接口
      GET
    • 历史天气
      GET
    • 空气污染指数
      GET
    • 专业31项生活指数预报
      GET
    • 全国空气质量指数排行榜
      GET
    • 空气污染指数最差的国家排名
      GET
    • 乡镇实况天气
      GET
    • 乡镇7日天气
      GET
    • 乡镇实况+7日天气
      GET
    • 四季天气
      GET
    • 全国实况天气数据列表接口
      GET
    • 免费实况天气接口
      GET
    • 免费7日天气接口
      GET
    • 全国天气降水量预报图接口
      GET
  • 其他类型接口
    • 短信验证码接口
    • 人脸融合接口
    • 人脸识别
    • 国内LBS逆地理编码服务 (区县级)
  1. 天气接口目录

历史天气

GET
https://v0.yiketianqi.com/api
可查询自2011年至今日的所有历史天气数据,返回当月天气列表,包含日期、天气情况、白天温度、夜间温度、风力风向、空气质量以及本月信息汇总(平均高温、平均低温、最差空气质量、最优空气质量、最差空气日期、最优空气日期)。
地区权限请求限制使用方案发票
全国3200个市区县每秒一次500/一年(最低) 2000/永久(最低)可提供普票、电子票、专票
全国所有市区县每日百万~千万次联系客服开通独享版本,最低12800/年可开普票、电子票、专票

请求参数

Query 参数
appid
string 
必需
注册开发者账号
示例值:
123456
appsecret
string 
必需
用户appsecret
示例值:
123456
version
string 
必需
固定值: history 每个接口的version值都不一样
示例值:
history
year
string 
年份
必需
示例值:
2023
month
string 
月份
必需
示例值:
3
cityid
string 
可选
请参考城市ID列表
city
string 
可选
不要带市和区; 如: 青岛、铁西
示例值:
北京

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://v0.yiketianqi.com/api?appid=123456&appsecret=123456&version=history&year=2023&month=3&cityid=&city=北京'

返回响应

🟢200成功
application/json
Body
cityid
string 
必需
city
string 
必需
cityEn
string 
必需
country
string 
必需
countryEn
string 
必需
update_time
string 
必需
data
array [object {21}] 
必需
date
string 
必需
wea
string 
必需
wea_img
string 
必需
tem1
string 
必需
tem2
string 
必需
win
array[string]
必需
win_speed
string 
必需
hours
array [object {6}] 
必需
time
string 
必需
level
string 
必需
value
string 
必需
ymd
string 
必需
bWendu
string 
白天温度
必需
yWendu
string 
夜晚温度
必需
tianqi
string 
天气情况
必需
tianqi_img
string 
天气情况图标
必需
fengxiang
string 
风向
必需
fengli
string 
风力
必需
aqi
string 
空气质量
必需
aqiInfo
string 
空气质量描述
必需
aqiLevel
string 
空气质量等级
必需
errcode
integer 
必需
errmsg
string 
必需
updateTime
string 
必需
updateTimeFormat
string 
必需
timeZone
string 
必需
latitude
string 
必需
longitude
string 
必需
day
object 
必需
icon
string 
必需
feelsLike
string 
必需
temperature
string 
必需
temperatureMaxSince7am
string 
必需
phrase
string 
必需
phrase_img
string 
必需
altimeter
string 
必需
barometerTrend
string 
必需
humidity
string 
必需
dewPoint
string 
必需
visibility
string 
必需
windSpeed
string 
必需
windDirCompass
string 
必需
windDirDegrees
string 
必需
uvIndex
string 
必需
uvDescription
string 
必需
sunrise
string 
必需
sunset
string 
必需
moonrise
string 
必需
moonset
string 
必需
moonIcon
string 
必需
moonPhrase
string 
必需
narrative
string 
必需
time
string 
必需
msg
string 
必需
list
array [object {33}] 
必需
time
string 
必需
时间点, 昨日数据是从0点开始-24点逐小时
value
integer  | number 
小时降雨量mm
必需
cityid
string 
必需
province
string 
必需
city
string 
必需
area
string 
必需
alarm_type
string 
必需
alarm_level
string 
必需
alarm_title
string 
必需
alarm_content
string 
必需
date
string 
必需
wea_day
string 
必需
wea_night
string 
必需
tem_day
string 
必需
tem_night
string 
必需
humidity
string 
必需
visibility
string 
必需
pressure
string 
必需
win
string 
必需
win_speed
string 
必需
win_meter
string 
必需
air
string 
必需
pm25
string 
必需
pm10
string 
必需
o3
string 
必需
no2
string 
必需
so2
string 
必需
co
string 
必需
sunrise
string 
必需
sunset
string 
必需
moonrise
string 
必需
moonset
string 
必需
moonIcon
string 
必需
runtime
number 
必需
nums
integer 
必需
days
integer 
必需
date_start
string 
必需
date_end
string 
必需
date
string 
必需
maxWendu
string 
最高温度
必需
minWendu
string 
最低问题
必需
avgbWendu
string 
白天平均温度
必需
avgyWendu
string 
晚上平均温度
必需
maxAqi
string 
最差空气质量
必需
minAqi
string 
最优空气质量
必需
maxAqiInfo
string 
必需
最差空气质量等级描述
maxAqiDate
string 
最差空气质量日期
必需
maxAqiLevel
string 
必需
最差空气质量等级1-5
minAqiInfo
string 
必需
最优空气质量等级描述
minAqiDate
string 
最优空气质量日期
必需
minAqiLevel
string 
必需
最优空气质量等级1-5
示例
{
    "cityid":"101120201",
    "date":"201909",
    "city":"青岛",
    "cityEn":"qingdao",
    "maxWendu":"30(2019-09-14)",//最高温度
    "minWendu":"15(2019-09-18)",//最低问题
    "avgbWendu":"27",//白天平均温度
    "avgyWendu":"20",//晚上平均温度
    "maxAqi":"120",//最差空气质量
    "minAqi":"53",//最优空气质量
    "maxAqiInfo":"轻度污染",//最差空气质量等级描述
    "maxAqiDate":"09月25日",//最差空气质量日期
    "maxAqiLevel":"3",//最差空气质量等级1-5
    "minAqiInfo":"空气优",//最优空气质量等级描述
    "minAqiDate":"09月01日",//最优空气质量日期
    "minAqiLevel":"1",//最优空气质量等级1-5
    "data":[
        {
            "ymd":"2019-09-01",
            "bWendu":"28℃",//白天温度
            "yWendu":"21℃",//夜晚温度
            "tianqi":"晴",//天气情况
            "tianqi_img":"qing",//天气情况图标
            "fengxiang":"东南风",//风向
            "fengli":"2级",//风力
            "aqi":"32",//空气质量
            "aqiInfo":"优",//空气质量描述
            "aqiLevel":"1"//空气质量等级
        },
        {
            "ymd":"2019-09-02",
            "bWendu":"28℃",
            "yWendu":"22℃",
            "tianqi":"晴~多云",
            "tianqi_img":"qing",//天气情况图标
            "fengxiang":"东南风",
            "fengli":"3级",
            "aqi":"34",
            "aqiInfo":"优",
            "aqiLevel":"1"
        }
        //....数据太多省略
    ]
}
上一页
新版历史天气接口
下一页
空气污染指数
Built with