线路类型一[普通集群负载-IP接口]
说明:直接访问https://api.apihz.cn/getapi.php获取当前最优IP接口地址。由普通负载集群服务器组成,通过IP接口地址调用,如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。
线路类型二[普通集群负载-域名接口]
说明:域名接口会自动分发请求到普通集群服务器均衡负载,该域名TTL值为60秒,表示你的请求会每60秒实现自动轮换负载服务器,但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障,也可能会造成个别地区存在一定时间的故障期。
线路类型三[VIP集群负载-VIP线路接口]
说明:VIP专属大带宽服务器集群组,每次请求自动均衡负载,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!最低24¥/月,登录后购买。注:VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等,并非收费接口包月使用。
请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)

复制全部

复制参数 

[POST]请求示例:(请根据开发语言自行POST,参考【GET/POST教程】。)

请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。参数内容较大的必须用POST,不能GET。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
名称 参数 必填 说明
开发者IDid用户中心的数字ID,例:id=10000000
开发者KEYkey用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2
排行类型type1=白天温度,2=夜间温度,默认按白天温度排行。例:type=1
排序方式px1=温度从高到低,2=温度从低到高,默认按温度从高到低排行。例:px=1
查询页码page查询页码,每页最多返回10条数据,默认第1页。例:page=1
动态秘钥dkey开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371
用户IPuip接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。
返回参数说明
名称 参数 说明
状态码code200成功,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
返回数据示例
示例:{"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"
        }
    }]
}
更新记录
2026-05-04 12:27:41 - 新增接口。

 天气预报-全国天气温度排行-2026-05-04 13:11:13

可查询全国2000多城市地区天气温度排行,可选白天或夜间排序。附加当日天气信息及当前天气信息等要素。

调用限制
调用权限 非定制接口直接使用
单价/次 免费[无上限]
单日[所有用户之和] 999999999
1分钟并发[所有用户之和] 999999999
1小时并发[所有用户之和] 999999999
频次限制[注册用户] 10次/分钟|每日无上限
频次限制[钻石会员] 最高8000+次/分钟|每日无上限
频次限制[定制频次] 联系我们定制
调用方法
请求方式 GET/POST
返回格式 JSON
编码格式 UTF-8
调用信息
浏览量 148
今日总计调用 0
昨日总计调用 0
历史总计调用 510
今日排名 451
总排名 365
自检信息
自检启用状态 未开启
自检节点 /
自检线路 彩钻接口线路
自检时间 /
自检耗时 / 毫秒
自检状态 /
历史自检成功数 / 次
历史自检失败数 / 次
历史自检成功率 / %
今日自检成功数 / 次
今日自检失败数 / 次
今日自检成功率 / %
天气预报-相关接口