接口盒子 天气预报1-7天-中国气象局-IP查询版
1. 接口线路类型一[集群IP接口]
-
[接口地址1] ：当前负载【优】 接口通讯
-
[接口地址2] ：当前负载【优】 接口通讯
-
[接口地址3] ：当前负载【优】 接口通讯
说明：直接访问https://api.apihz.cn/getapi.php获取当前最优接口地址，IP接口省去域名解析步骤，速度较快。集群IP接口并非永久有效，且容易遭受攻击，建议定期获取当前最优IP接口地址做容错处理，或直接使用域名接口或彩钻接口。IP直链接口CC防火墙严格。
2. 接口线路类型二[域名接口]
-
[接口地址] ：[自动分发到集群接口服务器，但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]
-
接口线路类型三[VIP线路超高稳定-最低24¥/月]
[VIP线路] ：[专属集群+普通集群+备用集群，自动负载均衡，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！CC防火墙宽松。登录后购买。注：VIP线路是指调用接口的线路更有保障以及更高的调用频次限制等，并非收费接口包月使用。]
-
请求示例
[GET]请求示例：(以下为公共KEY，共享每分钟调用频次，请登录后使用自己的KEY独享频次)
https://cn.apihz.cn/api/tianqi/tqybip.php?id=88888888&key=88888888&ip=49.234.56.79&day=1&hourtype=1
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】。)
3. 请求参数
请求参数说明注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。 提示：如发现接口有BUG，可加服务QQ群500700444，及时向我们反馈。 提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| ip地址 | ip | 否 | 要查询的ip，如不传则自动获取接口调用IP。如果查询失败，默认查询北京天气。例：ip=49.234.56.79 |
| 查询天数 | day | 否 | 可传1到7，代表1到7天内天气预报，默认1。例：day=1 |
| 时段天气 | hourtype | 否 | 是否返回时段天气预报，0=不返回，1=返回。默认0。例：hourtype=1 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。 |
4. 返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 如果状态码返回400则msg返回错误信息提示。 |
| 国家 | guo | 查询地址国家。 |
| 省级 | sheng | 查询地址省级。如果查询失败，默认查询北京天气。 |
| 市级 | shi | 查询地址市级或地区。如果查询失败，默认查询北京天气。 |
| 天气预报地址 | name | 天气预报地址。 |
| 当日白天天气 | weather1 | 当日白天天气。 |
| 当日夜间天气 | weather2 | 当日夜间天气。 |
| 当日白天温度 | wd1 | 当日白天温度。 |
| 当日夜间温度 | wd2 | 当日夜间温度。 |
| 当日白天风向 | winddirection1 | 当日白天风向。 |
| 当日夜间风向 | winddirection2 | 当日夜间风向。 |
| 当日白天风力等级 | windleve1 | 当日白天风力等级。 |
| 当日夜间风力等级 | windleve2 | 当日夜间风力等级。 |
| 当日白天天气图标 | weather1img | 当日白天天气图标。 |
| 当日夜间天气图标 | weather2img | 当日夜间天气图标。 |
| 地区经度 | lon | 地区经度。 |
| 地区纬度 | lat | 地区纬度。 |
| 当日天气更新时间 | uptime | 当日天气更新时间。 |
| 当前天气信息数据集 | nowinfo | 当前天气信息数据集。 |
| 降水量 | nowinfo.precipitation | 降水量。 |
| 温度 | nowinfo.temperature | 温度。 |
| 气压 | nowinfo.pressure | 气压。 |
| 湿度 | nowinfo.humidity | 湿度。 |
| 风向 | nowinfo.windDirection | 风向。 |
| 风向度 | nowinfo.windDirectionDegree | 风向度。 |
| 风速 | nowinfo.windSpeed | 风速。 |
| 风级 | nowinfo.windScale | 风级。 |
| 体感温度 | nowinfo.feelst | 体感温度。 |
| 当前天气信息更新时间 | nowinfo.uptime | 当前天气信息更新时间。 |
| 近期预警信息数据集 | alarm | 近期预警信息数据集，如有返回，没有返回null。 |
| 预警编号 | alarm.id | 预警编号，识别码。 |
| 预警标题 | alarm.title | 预警标题。 |
| 预警类别 | alarm.signaltype | 预警天气类别。 |
| 预警等级 | alarm.signallevel | 预警等级。 |
| 生效时间 | alarm.effective | 生效时间。 |
| 事件类型代码 | alarm.eventType | 事件类型代码。 |
| 预警等级英文 | alarm.severity | 预警等级英文。 |
| 预警类型代码 | alarm.type | 预警类型代码。 |
| 第2天天气数据集 | weatherday2 | 第2天天气数据集，数据集字段意思参考当日天气字段。 |
| 第3天天气数据集 | weatherday3 | 第3天天气数据集。 |
| 第4天天气数据集 | weatherday4 | 第4天天气数据集。 |
| 第5天天气数据集 | weatherday5 | 第5天天气数据集。 |
| 第6天天气数据集 | weatherday6 | 第6天天气数据集。 |
| 第7天天气数据集 | weatherday7 | 第7天天气数据集。 |
| 时段预报更新时间 | hourtime | 所有日期各时段天气信息整体更新时间。 |
| 当日各时段天气数据集 | hour1 | 当日各时段天气数据集。 |
| 第2天各时段天气 | hour2 | 第2天各时段天气。 |
| 第3天各时段天气 | hour3 | 第3天各时段天气。 |
| 第4天各时段天气 | hour4 | 第4天各时段天气。 |
| 第5天各时段天气 | hour5 | 第5天各时段天气。 |
| 第6天各时段天气 | hour6 | 第6天各时段天气。 |
| 第7天各时段天气 | hour7 | 第7天各时段天气。 |
5. 返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"guo": "中国",
"sheng": "四川",
"shi": "江油",
"name": "江油",
"weather1": "阵雨",
"weather2": "大雨",
"wd1": "30",
"wd2": "21",
"winddirection1": "无持续风向",
"winddirection2": "无持续风向",
"windleve1": "微风",
"windleve2": "微风",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/dayu.png",
"lon": "104.730",
"lat": "31.800",
"uptime": "2025-08-22 12:00:00",
"nowinfo": {
"precipitation": 0,
"temperature": 27.9,
"pressure": 944,
"humidity": 67,
"windDirection": "东北风",
"windDirectionDegree": 83,
"windSpeed": 4.2,
"windScale": "3级",
"feelst": 29.4,
"uptime": "2025/08/22 13:45"
},
"alarm": {
"id": "51078141600000_20250822091211",
"title": "江油市气象台发布暴雨黄色预警信号[III级/较重]",
"signaltype": "暴雨",
"signallevel": "黄色",
"effective": "2025/08/22 09:12",
"eventType": "11B03",
"severity": "YELLOW",
"type": "p0002003"
},
"weatherday2": {
"date": "2025/08/23",
"weather1": "阵雨",
"weather2": "阵雨",
"wd1": 28,
"wd2": 22,
"winddirection1": "无持续风向",
"winddirection2": "无持续风向",
"windleve1": "微风",
"windleve2": "微风",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png"
},
"hourtime": "2025-08-22 13:01:18",
"hour1": [{
"时间": "14:00",
"天气": "晴",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/qing.png",
"气温": "29.6℃",
"降水": "无降水",
"风速": "3.3m/s",
"风向": "东南风",
"气压": "915.8hPa",
"湿度": "76.2%",
"云量": "7.7%"
}, {
"时间": "17:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "30℃",
"降水": "3.8mm",
"风速": "3.3m/s",
"风向": "东南风",
"气压": "914.6hPa",
"湿度": "75.6%",
"云量": "70%"
}, {
"时间": "20:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "26.5℃",
"降水": "4.3mm",
"风速": "3.1m/s",
"风向": "东北风",
"气压": "916.2hPa",
"湿度": "82.6%",
"云量": "70%"
}, {
"时间": "23:00",
"天气": "中雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",
"气温": "22.5℃",
"降水": "4.9mm",
"风速": "3.2m/s",
"风向": "西北风",
"气压": "916.9hPa",
"湿度": "89.1%",
"云量": "70%"
}, {
"时间": "02:00",
"天气": "中雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",
"气温": "22.2℃",
"降水": "8.4mm",
"风速": "3.3m/s",
"风向": "西北风",
"气压": "915.8hPa",
"湿度": "95.7%",
"云量": "91.4%"
}, {
"时间": "05:00",
"天气": "中雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",
"气温": "21.9℃",
"降水": "5.4mm",
"风速": "3.3m/s",
"风向": "东北风",
"气压": "915.8hPa",
"湿度": "94.1%",
"云量": "100%"
}, {
"时间": "08:00",
"天气": "中雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",
"气温": "21.8℃",
"降水": "6.2mm",
"风速": "3.1m/s",
"风向": "西北风",
"气压": "917.2hPa",
"湿度": "73.6%",
"云量": "96.7%"
}, {
"时间": "11:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "24.2℃",
"降水": "8.7mm",
"风速": "3.3m/s",
"风向": "东北风",
"气压": "917.3hPa",
"湿度": "79.7%",
"云量": "91.5%"
}],
"hour2": [{
"时间": "08:00",
"天气": "中雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhongyu.png",
"气温": "21.8℃",
"降水": "6.2mm",
"风速": "3.1m/s",
"风向": "西北风",
"气压": "917.2hPa",
"湿度": "73.6%",
"云量": "96.7%"
}, {
"时间": "11:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "24.2℃",
"降水": "8.7mm",
"风速": "3.3m/s",
"风向": "东北风",
"气压": "917.3hPa",
"湿度": "79.7%",
"云量": "91.5%"
}, {
"时间": "14:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "28.2℃",
"降水": "3mm",
"风速": "2.9m/s",
"风向": "东北风",
"气压": "916.9hPa",
"湿度": "88.5%",
"云量": "100%"
}, {
"时间": "17:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "28.6℃",
"降水": "2.7mm",
"风速": "3.2m/s",
"风向": "东南风",
"气压": "915.9hPa",
"湿度": "86.9%",
"云量": "100%"
}, {
"时间": "20:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "27.9℃",
"降水": "4mm",
"风速": "2.6m/s",
"风向": "西北风",
"气压": "917.3hPa",
"湿度": "89.9%",
"云量": "85.9%"
}, {
"时间": "23:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "24.5℃",
"降水": "0.1mm",
"风速": "3.2m/s",
"风向": "西南风",
"气压": "918.5hPa",
"湿度": "94.3%",
"云量": "97.3%"
}, {
"时间": "02:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "23.6℃",
"降水": "无降水",
"风速": "3.3m/s",
"风向": "西北风",
"气压": "917.6hPa",
"湿度": "95.3%",
"云量": "69.5%"
}, {
"时间": "05:00",
"天气": "阵雨",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/zhenyu.png",
"气温": "23.1℃",
"降水": "2mm",
"风速": "3.1m/s",
"风向": "东北风",
"气压": "917.5hPa",
"湿度": "97.2%",
"云量": "85.1%"
}]
}