接口简介:
可查询全国2000多城市地区天气温度排行,可选白天或夜间排序。附加当日天气信息及当前天气信息等要素。
请求地址:
https://cn.apihz.cn/api/tianqi/tqybwdpx.php
请求方式:
POST或GET。
请求参数:
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID,例:id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2】
【排行类型】【type】【否】【1=白天温度,2=夜间温度,默认按白天温度排行。例:type=1】
【排序方式】【px】【否】【1=温度从高到低,2=温度从低到高,默认按温度从高到低排行。例:px=1】
【查询页码】【page】【否】【查询页码,每页最多返回10条数据,默认第1页。例:page=1】
返回参数:
【名称】【参数】【说明】
【状态码】【code】【200成功,400错误】
【信息提示】【msg】【信息提示】
【当前页码】【page】【当前页码】
【最大页码】【maxpage】【最大页码】
【排名数据集】【data】【排名数据集】
【排名】【data.top】【排名】
【省级名称】【data.sheng】【省级名称】
【市级名称】【data.shi】【市级名称】
【地区名称】【data.name】【地区名称】
【白天温度】【data.wd1】【白天温度】
【夜间温度】【data.wd2】【夜间温度】
【白天天气】【data.weather1】【白天天气】
【夜间天气】【data.weather2】【夜间天气】
【白天天气图标】【data.weather1img】【白天天气图标】
【夜间天气图标】【data.weather2img】【夜间天气图标】
【白天风向】【data.winddirection1】【白天风向】
【夜间风向】【data.winddirection2】【夜间风向】
【白天风力等级】【data.windleve1】【白天风力等级】
【夜间风力等级】【data.windleve2】【夜间风力等级】
【当前天气数据集】【data.nowdata】【当前天气数据集】
【当前降水量】【data.nowdata.precipitation】【当前降水量】
【当前温度】【data.nowdata.temperature】【当前温度】
【当前气压】【data.nowdata.pressure】【当前气压】
【当前湿度】【data.nowdata.humidity】【当前湿度】
【当前风向】【data.nowdata.windDirection】【当前风向】
【当前风向度】【data.nowdata.windDirectionDegree】【当前风向度】
【当前风速】【data.nowdata.windSpeed】【当前风速】
【当前风力】【data.nowdata.windScale】【当前风力】
【当前体感温度】【data.nowdata.feelst】【当前体感温度】
【当前天气更新时间】【data.nowdata.uptime】【当前天气信息更新时间,个别地区某些数据可能没有更新,会显示9999】
GET请求示例:
https://cn.apihz.cn/api/tianqi/tqybwdpx.php?id=88888888&key=88888888&type=1&px=1&page=1
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
"code": 200,
"page": 1,
"maxpage": 244,
"data": [{
"top": 1,
"sheng": "新疆",
"shi": "托克逊",
"name": "托克逊",
"wd1": "38",
"wd2": "20",
"weather1": "多云",
"weather2": "多云",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"winddirection1": "西北风",
"winddirection2": "西风",
"windleve1": "5~6级",
"windleve2": "5~6级",
"nowdata": {
"precipitation": 0,
"temperature": 33.2,
"pressure": 998,
"humidity": 7,
"windDirection": "东北风",
"windDirectionDegree": 87,
"windSpeed": 2.7,
"windScale": "微风",
"feelst": 31.8,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 2,
"sheng": "新疆",
"shi": "吐鲁番",
"name": "吐鲁番",
"wd1": "37",
"wd2": "21",
"weather1": "多云",
"weather2": "阴",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/yin.png",
"winddirection1": "南风",
"winddirection2": "北风",
"windleve1": "微风",
"windleve2": "3~4级",
"nowdata": {
"precipitation": 0,
"temperature": 31.4,
"pressure": 998,
"humidity": 6,
"windDirection": "东南风",
"windDirectionDegree": 113,
"windSpeed": 2.4,
"windScale": "微风",
"feelst": 29.9,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 3,
"sheng": "新疆",
"shi": "鄯善",
"name": "鄯善",
"wd1": "34",
"wd2": "18",
"weather1": "多云",
"weather2": "阴",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/yin.png",
"winddirection1": "西南风",
"winddirection2": "西风",
"windleve1": "3~4级",
"windleve2": "3~4级",
"nowdata": {
"precipitation": 0,
"temperature": 31.3,
"pressure": 952,
"humidity": 10,
"windDirection": "西南风",
"windDirectionDegree": 209,
"windSpeed": 3.5,
"windScale": "3级",
"feelst": 29.4,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 4,
"sheng": "海南",
"shi": "三亚",
"name": "三亚",
"wd1": "32",
"wd2": "24",
"weather1": "多云",
"weather2": "多云",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"winddirection1": "无持续风向",
"winddirection2": "无持续风向",
"windleve1": "微风",
"windleve2": "微风",
"nowdata": {
"precipitation": 0,
"temperature": 30.5,
"pressure": 1013,
"humidity": 76,
"windDirection": "西北风",
"windDirectionDegree": 282,
"windSpeed": 1.5,
"windScale": "微风",
"feelst": 35.6,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 5,
"sheng": "新疆",
"shi": "尉犁",
"name": "尉犁",
"wd1": "32",
"wd2": "16",
"weather1": "阴",
"weather2": "多云",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/yin.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"winddirection1": "北风",
"winddirection2": "东北风",
"windleve1": "微风",
"windleve2": "微风",
"nowdata": {
"precipitation": 0,
"temperature": 27.3,
"pressure": 907,
"humidity": 14,
"windDirection": "东南风",
"windDirectionDegree": 127,
"windSpeed": 1.2,
"windScale": "微风",
"feelst": 26.7,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 6,
"sheng": "海南",
"shi": "保亭",
"name": "保亭",
"wd1": "32",
"wd2": "23",
"weather1": "雷阵雨",
"weather2": "雷阵雨",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/leizhenyu.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/leizhenyu.png",
"winddirection1": "无持续风向",
"winddirection2": "无持续风向",
"windleve1": "微风",
"windleve2": "微风",
"nowdata": {
"precipitation": 0,
"temperature": 30.5,
"pressure": 1006,
"humidity": 63,
"windDirection": "东南风",
"windDirectionDegree": 164,
"windSpeed": 0.4,
"windScale": "微风",
"feelst": 35.2,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 7,
"sheng": "海南",
"shi": "西沙",
"name": "西沙",
"wd1": "31",
"wd2": "27",
"weather1": "多云",
"weather2": "多云",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"winddirection1": "东北风",
"winddirection2": "东北风",
"windleve1": "3~4级",
"windleve2": "3~4级",
"nowdata": {
"precipitation": 0,
"temperature": 32,
"pressure": 1013,
"humidity": 67,
"windDirection": "东北风",
"windDirectionDegree": 58,
"windSpeed": 3.1,
"windScale": "微风",
"feelst": 35.9,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 8,
"sheng": "新疆",
"shi": "乌苏",
"name": "乌苏",
"wd1": "31",
"wd2": "19",
"weather1": "多云",
"weather2": "多云",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"winddirection1": "西风",
"winddirection2": "西风",
"windleve1": "3~4级",
"windleve2": "微风",
"nowdata": {
"precipitation": 0,
"temperature": 26.7,
"pressure": 954,
"humidity": 22,
"windDirection": "西南风",
"windDirectionDegree": 259,
"windSpeed": 4.8,
"windScale": "3级",
"feelst": 24.3,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 9,
"sheng": "新疆",
"shi": "博乐",
"name": "博乐",
"wd1": "31",
"wd2": "12",
"weather1": "多云",
"weather2": "多云",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"winddirection1": "西风",
"winddirection2": "东南风",
"windleve1": "微风",
"windleve2": "微风",
"nowdata": {
"precipitation": 0,
"temperature": 26.8,
"pressure": 949,
"humidity": 23,
"windDirection": "东南风",
"windDirectionDegree": 104,
"windSpeed": 2.7,
"windScale": "微风",
"feelst": 25.8,
"uptime": "2026/05/04 12:40"
}
}, {
"top": 10,
"sheng": "新疆",
"shi": "哈密",
"name": "哈密",
"wd1": "31",
"wd2": "12",
"weather1": "多云",
"weather2": "阴",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/yin.png",
"winddirection1": "西南风",
"winddirection2": "东北风",
"windleve1": "微风",
"windleve2": "3~4级",
"nowdata": {
"precipitation": 0,
"temperature": 28.6,
"pressure": 921,
"humidity": 10,
"windDirection": "西南风",
"windDirectionDegree": 200,
"windSpeed": 1.3,
"windScale": "微风",
"feelst": 27.8,
"uptime": "2026/05/04 12:40"
}
}]
}
参考资料(版权):
https://www.apihz.cn/api/tianqitqybwdpx.html