接口线路类型一[集群IP接口]
[接口地址1] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址2] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址3] :当前负载【】 接口通讯【正常

复制

测速 

说明:直接访问https://api.apihz.cn/getapi.php获取当前最优接口地址,IP接口省去域名解析步骤,速度较快。集群IP接口并非永久有效,且容易遭受攻击,建议定期获取当前最优IP接口地址做容错处理,或直接使用域名接口或彩钻接口。IP直链接口CC防火墙严格。
接口线路类型二[域名接口]
[接口地址] :[自动分发到集群接口服务器,但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]

复制

测速 

接口线路类型三[VIP线路超高稳定-最低24¥/月]
[VIP线路] :[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。登录后购买。注:VIP线路是指调用接口的线路更有保障以及更高的调用频次限制等,并非收费接口包月使用。]

复制

测速 

请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)

复制全部

复制参数 

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

请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。参数内容较大的必须用POST,不能GET。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
名称 参数 必填 说明
开发者IDid用户中心的数字ID,例:id=10000000
开发者KEYkey用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2
城市名称city要查询的国外城市名称,标准化城市名称请参考【国外主要城市天气6天-中国气象局-地址列表】接口(https://www.apihz.cn/api/tianqitqyblistun.html),例:city=亚特兰大
动态秘钥dkey开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371
用户IPuip接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。
返回参数说明
名称 参数 说明
状态码code200成功,400错误
消息内容msg信息提示。
国家guo国家。
城市city城市。
每日天气数据集weatherday1-6每日天气数据集。
日期weatherday.date日期。
星期weatherday.weekday星期。
日期2weatherday.monthDay日期2。
白天天气weatherday.weather1白天天气。
夜间天气weatherday.weather2夜间天气。
白天温度weatherday.wd1白天温度。
夜间温度weatherday.wd2夜间温度。
白天风向weatherday.winddirection1白天风向。
夜间风向weatherday.winddirection2夜间风向。
白天风力weatherday.windleve1白天风力。
夜间风力weatherday.windleve2夜间风力。
白天天气图标weatherday.weather1img白天天气图标。
夜间天气图标weatherday.weather2img夜间天气图标。
更新时间uptime更新时间。
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
    "code": 200,
    "guo": "美国",
    "city": "亚特兰大",
    "weatherday1": {
        "date": "2026/02/05",
        "weekday": "星期四",
        "monthDay": "02/05",
        "weather1": "晴",
        "weather2": "晴",
        "wd1": 7,
        "wd2": -1,
        "winddirection1": "西北风",
        "winddirection2": "西北风",
        "windleve1": "微风",
        "windleve2": "5级",
        "weather1img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png",
        "weather2img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png"
    },
    "weatherday2": {
        "date": "2026/02/06",
        "weekday": "星期五",
        "monthDay": "02/06",
        "weather1": "晴",
        "weather2": "晴",
        "wd1": 16,
        "wd2": 0,
        "winddirection1": "西北风",
        "winddirection2": "西北风",
        "windleve1": "6级",
        "windleve2": "6级",
        "weather1img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png",
        "weather2img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png"
    },
    "weatherday3": {
        "date": "2026/02/07",
        "weekday": "星期六",
        "monthDay": "02/07",
        "weather1": "晴",
        "weather2": "晴",
        "wd1": 7,
        "wd2": -2,
        "winddirection1": "西北风",
        "winddirection2": "西北风",
        "windleve1": "6级",
        "windleve2": "5级",
        "weather1img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png",
        "weather2img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png"
    },
    "weatherday4": {
        "date": "2026/02/08",
        "weekday": "星期日",
        "monthDay": "02/08",
        "weather1": "晴",
        "weather2": "晴",
        "wd1": 13,
        "wd2": -2,
        "winddirection1": "西南风",
        "winddirection2": "西南风",
        "windleve1": "3级",
        "windleve2": "3级",
        "weather1img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png",
        "weather2img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png"
    },
    "weatherday5": {
        "date": "2026/02/09",
        "weekday": "星期一",
        "monthDay": "02/09",
        "weather1": "晴",
        "weather2": "阴",
        "wd1": 20,
        "wd2": 3,
        "winddirection1": "西南风",
        "winddirection2": "西北风",
        "windleve1": "5级",
        "windleve2": "3级",
        "weather1img": "https://rescdn.apihz.cn/resimg/tianqi/w0.png",
        "weather2img": "https://rescdn.apihz.cn/resimg/tianqi/w2.png"
    },
    "weatherday6": {
        "date": "2026/02/10",
        "weekday": "星期二",
        "monthDay": "02/10",
        "weather1": "阴",
        "weather2": "多云",
        "wd1": 21,
        "wd2": 9,
        "winddirection1": "西北风",
        "winddirection2": "西南风",
        "windleve1": "3级",
        "windleve2": "3级",
        "weather1img": "https://rescdn.apihz.cn/resimg/tianqi/w2.png",
        "weather2img": "https://rescdn.apihz.cn/resimg/tianqi/w1.png"
    },
    "uptime": "2026-02-06 15:01:01"
}
更新记录
2026-02-06 15:28:19 - 新增接口。

 天气预报-国外主要城市天气预报6天-中国气象局-地址查询版-2026-02-06 15:58:01

根据国外城市地址获取指定地址6日天气信息,来源于中国气象局官方数据。可查询地址列表可调用接口【国外主要城市天气6天-中国气象局-地址列表】https://www.apihz.cn/api/tianqitqyblistun.html

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