接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 经度 | lon | 是 | 经度。国外坐标默认返回北京天气。例：lon=116.294908 |
| 纬度 | lat | 是 | 纬度。国外坐标默认返回北京天气。例：lat=40.049646 |
| 查询天数 | day | 否 | 可传1到7，代表1到7天内天气预报，默认1。例：day=1 |
| 时段天气 | hourtype | 否 | 是否返回时段天气预报，0=不返回，1=返回。默认0。例：hourtype=1 |
| 日出落时间表 | suntimetype | 否 | 是否返回7天日出日落详细时间。0=不返回，1=返回。默认0。例：suntimetype=1 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | 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天各时段天气。 |
| 日出日落时间表数据集 | suntimes | 7天日出日落详细时间表数据集。 |
| 日期 | suntimes.date | 日期。 |
| 格式化日期 | suntimes.date_formatted | 格式化日期。 |
| 星期几英文全 | suntimes.weekday | 星期几英文全称。 |
| 星期几英文缩 | suntimes.weekday_short | 星期几英文缩写。 |
| 星期几中文全 | suntimes.weekday_cn | 星期几中文全称。 |
| 星期几中文缩 | suntimes.weekday_short_cn | 星期几中文缩写。 |
| 民用晨光始 | suntimes.civil_twilight_begin | 讲人话就是天亮时间。 |
| 日出时间 | suntimes.sunrise | 日出时间。 |
| 太阳正午 | suntimes.transit | 太阳正午。 |
| 日落时间 | suntimes.sunset | 日落时间。 |
| 民用昏影终 | suntimes.civil_twilight_end | 讲人话就是天黑时间。 |
| 天文晨光始 | suntimes.astronomical_twilight_begin | 天文晨光始（太阳中心在地平线下18度），天空开始有微弱光线。 |
| 航海晨光始 | suntimes.nautical_twilight_begin | 航海晨光始（太阳中心在地平线下12度），地平线隐约可见。 |
| 航海昏影终 | suntimes.nautical_twilight_end | 航海昏影终（太阳中心在地平线下12度），地平线不可见。 |
| 天文昏影终 | suntimes.astronomical_twilight_end | 天文昏影终（太阳中心在地平线下18度），完全黑暗。 |
| 昼长 | suntimes.day_length_seconds | 昼长（日出到日落）的秒数。 |
| 夜长 | suntimes.night_length_seconds | 夜长（简化计算：24小时-昼长）的秒数。 |
| 精确夜长 | suntimes.night_length_accurate_seconds | 精确夜长（当天日落到第二天日出）的秒数。 |
| 晨光时长 | suntimes.twilight_morning_seconds | 晨光时长（天亮到日出）的秒数。 |
| 昏影时长 | suntimes.twilight_evening_seconds | 昏影时长（日落到天黑）的秒数。 |
| 总天亮时长 | suntimes.daylight_duration_seconds | 总天亮时长（天亮到天黑）的秒数。 |
| 昼长格式化 | suntimes.day_length | 昼长，格式化。 |
| 夜长格式化 | suntimes.night_length | 夜长格式化。 |
| 精确夜长格式化 | suntimes.night_length_accurate | 精确夜长格式化。 |
| 晨光时长格式化 | suntimes.twilight_morning | 晨光时长格式化。 |
| 昏影时长格式化 | suntimes.twilight_evening | 昏影时长格式化。 |
| 总天亮时长格式化 | suntimes.daylight_duration | 总天亮时长格式化。 |
| 昼长百分比 | suntimes.day_percentage | 昼长百分百。 |
| 夜长百分比 | suntimes.night_percentage | 夜长百分比。 |
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"guo": "中国",
"sheng": "云南",
"shi": "砚山",
"name": "砚山",
"weather1": "多云",
"weather2": "多云",
"wd1": "27",
"wd2": "14",
"winddirection1": "西南风",
"winddirection2": "无持续风向",
"windleve1": "3~4级",
"windleve2": "微风",
"weather1img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"weather2img": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"lon": "104.340",
"lat": "23.600",
"uptime": "2026-03-30 12:00:00",
"nowinfo": {
"precipitation": 0,
"temperature": 28.2,
"pressure": 837,
"humidity": 23,
"windDirection": "西南风",
"windDirectionDegree": 264,
"windSpeed": 4.5,
"windScale": "3级",
"feelst": 26.3,
"uptime": "2026/03/30 15:40"
},
"alarm": [{
"id": "53262241600000_20260330123645",
"title": "砚山县气象台发布大风蓝色预警[Ⅳ级/一般]",
"signaltype": "大风",
"signallevel": "蓝色",
"effective": "2026/03/30 12:37",
"eventType": "11B06",
"severity": "BLUE",
"type": "p0007004"
}],
"hourtime": "2026-03-30 15:48:14",
"hour1": [{
"时间": "17:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "26.9℃",
"降水": "无降水",
"风速": "6.7m/s",
"风向": "西南风",
"气压": "834.9hPa",
"湿度": "45.8%",
"云量": "10.5%"
}, {
"时间": "20:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "21.9℃",
"降水": "无降水",
"风速": "5.5m/s",
"风向": "西南风",
"气压": "836.2hPa",
"湿度": "56.7%",
"云量": "10.7%"
}, {
"时间": "23:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "18.9℃",
"降水": "无降水",
"风速": "3.3m/s",
"风向": "西南风",
"气压": "837.6hPa",
"湿度": "56.9%",
"云量": "31.9%"
}, {
"时间": "02:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "16.2℃",
"降水": "无降水",
"风速": "2.5m/s",
"风向": "西南风",
"气压": "837.2hPa",
"湿度": "57.3%",
"云量": "55.5%"
}, {
"时间": "05:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "14.8℃",
"降水": "无降水",
"风速": "2.2m/s",
"风向": "西南风",
"气压": "836.9hPa",
"湿度": "77.5%",
"云量": "10.1%"
}, {
"时间": "08:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "14.8℃",
"降水": "无降水",
"风速": "2.9m/s",
"风向": "西南风",
"气压": "838.7hPa",
"湿度": "79.3%",
"云量": "10.1%"
}, {
"时间": "11:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "23.2℃",
"降水": "无降水",
"风速": "3.2m/s",
"风向": "东北风",
"气压": "839.5hPa",
"湿度": "52.8%",
"云量": "10.1%"
}, {
"时间": "14:00",
"天气": "多云",
"图标": "https://rescdn.apihz.cn/resimg/tianqi/duoyun.png",
"气温": "23.6℃",
"降水": "无降水",
"风速": "2.1m/s",
"风向": "东北风",
"气压": "837.8hPa",
"湿度": "55.4%",
"云量": "33.2%"
}],
"suntimes": [{
"date": "2026-03-30",
"date_formatted": "2026年03月30日",
"weekday": "Monday",
"weekday_short": "Mon",
"weekday_cn": "星期一",
"weekday_short_cn": "周一",
"civil_twilight_begin": "06:34:16",
"sunrise": "06:56:51",
"transit": "13:07:10",
"sunset": "19:17:30",
"civil_twilight_end": "19:40:05",
"astronomical_twilight_begin": "05:41:07",
"nautical_twilight_begin": "06:07:48",
"nautical_twilight_end": "20:06:33",
"astronomical_twilight_end": "20:33:14",
"day_length_seconds": 44439,
"night_length_seconds": 41902,
"night_length_accurate_seconds": 41902,
"twilight_morning_seconds": 1355,
"twilight_evening_seconds": 1355,
"daylight_duration_seconds": 47149,
"day_length": "12:20:39",
"night_length": "11:38:22",
"night_length_accurate": "11:38:22",
"twilight_morning": "00:22:35",
"twilight_evening": "00:22:35",
"daylight_duration": "13:05:49",
"day_percentage": 51.4,
"night_percentage": 48.5
}, {
"date": "2026-03-31",
"date_formatted": "2026年03月31日",
"weekday": "Tuesday",
"weekday_short": "Tue",
"weekday_cn": "星期二",
"weekday_short_cn": "周二",
"civil_twilight_begin": "06:33:16",
"sunrise": "06:55:52",
"transit": "13:06:52",
"sunset": "19:17:53",
"civil_twilight_end": "19:40:29",
"astronomical_twilight_begin": "05:40:02",
"nautical_twilight_begin": "06:06:46",
"nautical_twilight_end": "20:06:59",
"astronomical_twilight_end": "20:33:42",
"day_length_seconds": 44521,
"night_length_seconds": 41820,
"night_length_accurate_seconds": 41820,
"twilight_morning_seconds": 1356,
"twilight_evening_seconds": 1356,
"daylight_duration_seconds": 47233,
"day_length": "12:22:01",
"night_length": "11:37:00",
"night_length_accurate": "11:37:00",
"twilight_morning": "00:22:36",
"twilight_evening": "00:22:36",
"daylight_duration": "13:07:13",
"day_percentage": 51.5,
"night_percentage": 48.4
}, {
"date": "2026-04-01",
"date_formatted": "2026年04月01日",
"weekday": "Wednesday",
"weekday_short": "Wed",
"weekday_cn": "星期三",
"weekday_short_cn": "周三",
"civil_twilight_begin": "06:32:16",
"sunrise": "06:54:53",
"transit": "13:06:34",
"sunset": "19:18:16",
"civil_twilight_end": "19:40:53",
"astronomical_twilight_begin": "05:38:58",
"nautical_twilight_begin": "06:05:44",
"nautical_twilight_end": "20:07:25",
"astronomical_twilight_end": "20:34:11",
"day_length_seconds": 44603,
"night_length_seconds": 41739,
"night_length_accurate_seconds": 41739,
"twilight_morning_seconds": 1357,
"twilight_evening_seconds": 1357,
"daylight_duration_seconds": 47317,
"day_length": "12:23:23",
"night_length": "11:35:39",
"night_length_accurate": "11:35:39",
"twilight_morning": "00:22:37",
"twilight_evening": "00:22:37",
"daylight_duration": "13:08:37",
"day_percentage": 51.6,
"night_percentage": 48.3
}, {
"date": "2026-04-02",
"date_formatted": "2026年04月02日",
"weekday": "Thursday",
"weekday_short": "Thu",
"weekday_cn": "星期四",
"weekday_short_cn": "周四",
"civil_twilight_begin": "06:31:16",
"sunrise": "06:53:55",
"transit": "13:06:17",
"sunset": "19:18:39",
"civil_twilight_end": "19:41:18",
"astronomical_twilight_begin": "05:37:54",
"nautical_twilight_begin": "06:04:43",
"nautical_twilight_end": "20:07:51",
"astronomical_twilight_end": "20:34:40",
"day_length_seconds": 44684,
"night_length_seconds": 41657,
"night_length_accurate_seconds": 41657,
"twilight_morning_seconds": 1359,
"twilight_evening_seconds": 1359,
"daylight_duration_seconds": 47402,
"day_length": "12:24:44",
"night_length": "11:34:17",
"night_length_accurate": "11:34:17",
"twilight_morning": "00:22:39",
"twilight_evening": "00:22:39",
"daylight_duration": "13:10:02",
"day_percentage": 51.7,
"night_percentage": 48.2
}, {
"date": "2026-04-03",
"date_formatted": "2026年04月03日",
"weekday": "Friday",
"weekday_short": "Fri",
"weekday_cn": "星期五",
"weekday_short_cn": "周五",
"civil_twilight_begin": "06:30:16",
"sunrise": "06:52:56",
"transit": "13:05:59",
"sunset": "19:19:02",
"civil_twilight_end": "19:41:42",
"astronomical_twilight_begin": "05:36:49",
"nautical_twilight_begin": "06:03:41",
"nautical_twilight_end": "20:08:17",
"astronomical_twilight_end": "20:35:09",
"day_length_seconds": 44766,
"night_length_seconds": 41576,
"night_length_accurate_seconds": 41576,
"twilight_morning_seconds": 1360,
"twilight_evening_seconds": 1360,
"daylight_duration_seconds": 47486,
"day_length": "12:26:06",
"night_length": "11:32:56",
"night_length_accurate": "11:32:56",
"twilight_morning": "00:22:40",
"twilight_evening": "00:22:40",
"daylight_duration": "13:11:26",
"day_percentage": 51.8,
"night_percentage": 48.1
}, {
"date": "2026-04-04",
"date_formatted": "2026年04月04日",
"weekday": "Saturday",
"weekday_short": "Sat",
"weekday_cn": "星期六",
"weekday_short_cn": "周六",
"civil_twilight_begin": "06:29:17",
"sunrise": "06:51:58",
"transit": "13:05:42",
"sunset": "19:19:25",
"civil_twilight_end": "19:42:06",
"astronomical_twilight_begin": "05:35:45",
"nautical_twilight_begin": "06:02:39",
"nautical_twilight_end": "20:08:44",
"astronomical_twilight_end": "20:35:39",
"day_length_seconds": 44847,
"night_length_seconds": 41495,
"night_length_accurate_seconds": 41495,
"twilight_morning_seconds": 1361,
"twilight_evening_seconds": 1361,
"daylight_duration_seconds": 47569,
"day_length": "12:27:27",
"night_length": "11:31:35",
"night_length_accurate": "11:31:35",
"twilight_morning": "00:22:41",
"twilight_evening": "00:22:41",
"daylight_duration": "13:12:49",
"day_percentage": 51.9,
"night_percentage": 48
}, {
"date": "2026-04-05",
"date_formatted": "2026年04月05日",
"weekday": "Sunday",
"weekday_short": "Sun",
"weekday_cn": "星期日",
"weekday_short_cn": "周日",
"civil_twilight_begin": "06:28:18",
"sunrise": "06:51:00",
"transit": "13:05:24",
"sunset": "19:19:48",
"civil_twilight_end": "19:42:31",
"astronomical_twilight_begin": "05:34:40",
"nautical_twilight_begin": "06:01:38",
"nautical_twilight_end": "20:09:11",
"astronomical_twilight_end": "20:36:08",
"day_length_seconds": 44928,
"night_length_seconds": 41472,
"night_length_accurate_seconds": 0,
"twilight_morning_seconds": 1362,
"twilight_evening_seconds": 1363,
"daylight_duration_seconds": 47653,
"day_length": "12:28:48",
"night_length": "11:31:12",
"night_length_accurate": "N/A",
"twilight_morning": "00:22:42",
"twilight_evening": "00:22:43",
"daylight_duration": "13:14:13",
"day_percentage": 52,
"night_percentage": 48
}]
}
更新记录
