| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
| 城市名称 | city | 是 | 要查询的国外城市名称,标准化城市名称请参考【国外主要城市天气6天-中国气象局-地址列表】接口(https://www.apihz.cn/api/tianqitqyblistun.html),例:city=亚特兰大 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功,400错误 |
| 消息内容 | msg | 信息提示。 |
| 国家 | guo | 国家。 |
| 城市 | city | 城市。 |
| 每日天气数据集 | weatherday1-6 | 每日天气数据集。 |
| 日期 | weatherday.date | 日期。 |
| 星期 | weatherday.weekday | 星期。 |
| 日期2 | weatherday.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日天气信息,来源于中国气象局官方数据。可查询地址列表可调用接口【国外主要城市天气6天-中国气象局-地址列表】https://www.apihz.cn/api/tianqitqyblistun.html
| 调用权限 | 非定制接口直接使用 |
| 单价/次 | 免费[无上限] |
| 单日[所有用户之和] | 999999999 |
| 1分钟并发[所有用户之和] | 999999999 |
| 1小时并发[所有用户之和] | 999999999 |
| 频次限制[注册用户] | 10次/分钟|每日无上限 |
| 频次限制[钻石会员] | 最高8000+次/分钟|每日无上限 |
| 频次限制[定制频次] | 联系我们定制 |
| 请求方式 | GET/POST |
| 返回格式 | JSON |
| 编码格式 | UTF-8 |
| 浏览量 | 353 |
| 今日总计调用 | 0 |
| 昨日总计调用 | 0 |
| 历史总计调用 | 548 |
| 今日排名 | 422 |
| 总排名 | 361 |
| 自检启用状态 | 未开启 |
| 自检节点 | / |
| 自检线路 | 彩钻接口线路 |
| 自检时间 | / |
| 自检耗时 | / 毫秒 |
| 自检状态 | / |
| 历史自检成功数 | / 次 |
| 历史自检失败数 | / 次 |
| 历史自检成功率 | / % |
| 今日自检成功数 | / 次 |
| 今日自检失败数 | / 次 |
| 今日自检成功率 | / % |