接口调用地址
线路类型一 [普通集群负载-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 |
| 起点 | star | 是 | 起点，可以是城市名，机场名，机场代码，如为城市名，尽量别传后缀，如上海市则传上海。标准名称可调用机场代码查询接口【https://www.apihz.cn/api/jiaotongjichangcode.html】。例：star=SHA |
| 终点 | end | 是 | 终点，可以是城市名，机场名，机场代码，如为城市名，尽量别传后缀，如上海市则传上海。标准名称可调用机场代码查询接口【https://www.apihz.cn/api/jiaotongjichangcode.html】。例：end=PEK |
| 出发年 | stary | 是 | 出发年 |
| 出发月 | starm | 是 | 出发月 |
| 出发日 | stard | 是 | 出发日 |
| cookie | ck | 否 | cookie |
| 查询通道 | type | 否 | 1或2，默认1号通道，2号通道返回数据字段较少，不同通道最低价格不一致，但相差无几。例：type=1 |
| 代理通道 | dl | 否 | 0=不使用代理，1=使用平台代理池，扣除5盟点，2=使用独享代理IP，扣除10盟点。一般在查询失败时可以尝试切换代理通道。 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 消息内容。 |
| 起点城市中文 | starnamecn | 起点城市中文。 |
| 终点城市中文 | endnamecn | 终点城市中文。 |
| 起点城市英文 | starnameen | 起点城市英文。 |
| 终点城市英文 | endnameen | 终点城市英文。 |
| 航班信息数据集 | datas | 航班信息数据集。 |
| 航班号 | datas.fno | 航班号。 |
| 航空公司代码 | datas.airlinecode | 航空公司代码。 |
| 航空公司名称 | datas.airlinename | 航空公司名称。 |
| 起飞时间 | datas.flystartime | 起飞时间。 |
| 到达时间 | datas.flyendtime | 到达时间。 |
| 飞行时长 | datas.flytime | 飞行时长。 |
| 出发机场名称 | datas.starairname | 出发机场名称。 |
| 出发机场代码 | datas.staraircode | 出发机场代码。 |
| 出发城市代码 | datas.starcitycode | 出发城市代码。 |
| 出发航站楼 | datas.starpoint | 出发航站楼。 |
| 到达机场名称 | datas.endairname | 到达机场名称。 |
| 到达机场代码 | datas.endaircode | 到达机场代码。 |
| 到达城市代码 | datas.endcitycode | 到达城市代码。 |
| 到达航站楼 | datas.endpoint | 到达航站楼。 |
| 飞机型号 | datas.fjmodel | 飞机型号。 |
| 飞机代码 | datas.fjcode | 飞机代码。 |
| 准点率 | datas.zdl | 准点率。 |
| 餐食服务 | datas.can | 餐食服务。 |
| 餐食描述 | datas.canmsg | 餐食描述。 |
| 飞机机龄 | datas.fyear | 飞机机龄。 |
| 廊桥率 | datas.bridge | 廊桥率。 |
| 平均延误 | datas.adl | 平均延误。 |
| 取消率 | datas.clp | 取消率。 |
| 值机时间(分钟) | datas.cot | 值机时间(分钟)。 |
| 登机时间(分钟) | datas.ot | 登机时间(分钟)。 |
| 经济舱最低价 | datas.jc | 经济舱最低价。 |
| 经济舱最低价折扣 | datas.jczk | 经济舱最低价折扣。 |
| 经济舱最低儿童价 | datas.jcet | 经济舱最低儿童价。 |
| 经济舱最低婴儿价 | datas.jcye | 经济舱最低婴儿价。 |
| 剩余票数 | datas.jccount | 剩余票数 A=充足 否则返回剩余数量。1号通道不返回。 |
| 公务舱最低价 | datas.gc | 公务舱最低价。 |
| 公务舱最低价折扣 | datas.gczk | 公务舱最低价折扣。 |
| 公务舱最低儿童价 | datas.gcet | 公务舱最低儿童价。 |
| 公务舱最低婴儿价 | datas.gcye | 公务舱最低婴儿价。 |
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"starnamecn": "上海",
"endnamecn": "北京",
"starnameen": "ShangHai",
"endnameen": "BeiJing",
"datas": [{
"fno": "HU7614",
"airlinecode": "HU",
"airlinename": "海航｜海南航空",
"flystartime": "2025-12-09 06:25",
"flyendtime": "2025-12-09 08:55",
"flytime": "2小时30分钟",
"starairname": "上海浦东国际机场",
"staraircode": "PVG",
"starcitycode": "SHA",
"starpoint": "T2",
"endairname": "北京首都国际机场",
"endaircode": "PEK",
"endcitycode": "BJS",
"endpoint": "T2",
"fjmodel": "波音737-800(中)",
"fjcode": "7CA",
"zdl": "100.00",
"can": "有",
"canmsg": "早餐",
"fyear": "机龄8.2年",
"bridge": "航班廊桥率93%",
"adl": "平均延误12分钟",
"clp": "航班取消率0%",
"cot": 20,
"ot": 40,
"jc": 380,
"jczk": 1,
"jcet": 380,
"jcye": 220,
"jccount": null,
"gc": 1200,
"gczk": 1,
"gcet": 1200,
"gcye": 840
}, {
"fno": "Y87614",
"airlinecode": "Y8",
"airlinename": "海航｜金鹏航空",
"flystartime": "2025-12-09 06:25",
"flyendtime": "2025-12-09 08:55",
"flytime": "2小时30分钟",
"starairname": "上海浦东国际机场",
"staraircode": "PVG",
"starcitycode": "SHA",
"starpoint": "T2",
"endairname": "北京首都国际机场",
"endaircode": "PEK",
"endcitycode": "BJS",
"endpoint": "T2",
"fjmodel": "波音737-800(中)",
"fjcode": "7CA",
"zdl": "100.00",
"can": "有",
"canmsg": "早餐",
"fyear": "机龄8.2年",
"bridge": "航班廊桥率93%",
"adl": "平均延误12分钟",
"clp": "航班取消率0%",
"cot": 20,
"ot": 40,
"jc": 900,
"jczk": 4,
"jcet": 1080,
"jcye": 220,
"jccount": null,
"gc": 8390,
"gczk": 10,
"gcet": 4200,
"gcye": 840
}, {
"fno": "MU5099",
"airlinecode": "MU",
"airlinename": "东方航空",
"flystartime": "2025-12-09 07:00",
"flyendtime": "2025-12-09 09:20",
"flytime": "2小时20分钟",
"starairname": "上海虹桥国际机场",
"staraircode": "SHA",
"starcitycode": "SHA",
"starpoint": "T2",
"endairname": "北京首都国际机场",
"endaircode": "PEK",
"endcitycode": "BJS",
"endpoint": "T2",
"fjmodel": "空客320(中)",
"fjcode": "327",
"zdl": "100.00",
"can": "有",
"canmsg": "早餐",
"fyear": "机龄2.5年",
"bridge": "航班廊桥率83%",
"adl": "平均延误13分钟",
"clp": "航班取消率3%",
"cot": 20,
"ot": 40,
"jc": 930,
"jczk": 4,
"jcet": 905,
"jcye": 220,
"jccount": null,
"gc": 2150,
"gczk": 2,
"gcet": 2110,
"gcye": 840
}, {
"fno": "3U5163",
"airlinecode": "3U",
"airlinename": "四川航空",
"flystartime": "2025-12-09 07:00",
"flyendtime": "2025-12-09 09:20",
"flytime": "2小时20分钟",
"starairname": "上海虹桥国际机场",
"staraircode": "SHA",
"starcitycode": "SHA",
"starpoint": "T2",
"endairname": "北京首都国际机场",
"endaircode": "PEK",
"endcitycode": "BJS",
"endpoint": "T2",
"fjmodel": "空客320(中)",
"fjcode": "327",
"zdl": "100.00",
"can": "有",
"canmsg": "热早餐",
"fyear": "机龄2.5年",
"bridge": "航班廊桥率83%",
"adl": "平均延误13分钟",
"clp": "航班取消率3%",
"cot": 20,
"ot": 40,
"jc": 930,
"jczk": 4,
"jcet": 1080,
"jcye": 220,
"jccount": null,
"gc": 2150,
"gczk": 2,
"gcet": 2110,
"gcye": 840
}, {
"fno": "MF3515",
"airlinecode": "MF",
"airlinename": "厦门航空",
"flystartime": "2025-12-09 07:00",
"flyendtime": "2025-12-09 09:20",
"flytime": "2小时20分钟",
"starairname": "上海虹桥国际机场",
"staraircode": "SHA",
"starcitycode": "SHA",
"starpoint": "T2",
"endairname": "北京首都国际机场",
"endaircode": "PEK",
"endcitycode": "BJS",
"endpoint": "T2",
"fjmodel": "空客320(中)",
"fjcode": "327",
"zdl": "100.00",
"can": "有",
"canmsg": "早餐",
"fyear": "机龄2.5年",
"bridge": "航班廊桥率83%",
"adl": "平均延误13分钟",
"clp": "航班取消率3%",
"cot": 20,
"ot": 40,
"jc": 940,
"jczk": 4,
"jcet": 1080,
"jcye": 220,
"jccount": null,
"gc": 2150,
"gczk": 2,
"gcet": 2110,
"gcye": 840
}, {
"fno": "HO5362",
"airlinecode": "HO",
"airlinename": "吉祥航空",
"flystartime": "2025-12-09 07:00",
"flyendtime": "2025-12-09 09:20",
"flytime": "2小时20分钟",
"starairname": "上海虹桥国际机场",
"staraircode": "SHA",
"starcitycode": "SHA",
"starpoint": "T2",
"endairname": "北京首都国际机场",
"endaircode": "PEK",
"endcitycode": "BJS",
"endpoint": "T2",
"fjmodel": "空客320(中)",
"fjcode": "327",
"zdl": "100.00",
"can": "有",
"canmsg": "早餐",
"fyear": "机龄2.5年",
"bridge": "航班廊桥率83%",
"adl": "平均延误13分钟",
"clp": "航班取消率3%",
"cot": 20,
"ot": 40,
"jc": 1080,
"jczk": 5,
"jcet": 1080,
"jcye": 220,
"jccount": null,
"gc": 2150,
"gczk": 2,
"gcet": 2110,
"gcye": 840
}, {
"fno": "CA1564",
"airlinecode": "CA",
"airlinename": "中国国际航空",
"flystartime": "2025-12-09 07:45",
"flyendtime": "2025-12-09 09:55",
"flytime": "2小时10分钟",
"starairname": "上海虹桥国际机场",
"staraircode": "SHA",
"starcitycode": "SHA",
"starpoint": "T3",
"endairname": "北京首都国际机场",
"endaircode": "PEK",
"endcitycode": "BJS",
"endpoint": "T2",
"fjmodel": "空客350(大)",
"fjcode": "359",
"zdl": "100.00",
"can": "有",
"canmsg": "早餐",
"fyear": "机龄10.4年",
"bridge": "航班廊桥率100%",
"adl": "平均延误11分钟",
"clp": "航班取消率7%",
"cot": 20,
"ot": 40,
"jc": 750,
"jczk": 3,
"jcet": 748,
"jcye": 220,
"jccount": null,
"gc": 2170,
"gczk": 2,
"gcet": 2158,
"gcye": 840
}, {
"fno": "SC5387",
"airlinecode": "SC",
"airlinename": "山东航空",
"flystartime": "2025-12-09 07:45",
"flyendtime": "2025-12-09 09:55",
"flytime": "2小时10分钟",
"starairname": "上海虹桥国际机场",
"staraircode": "SHA",
"starcitycode": "SHA",
"starpoint": "T3",
"endairname": "北京首都国际机场",
"endaircode": "PEK",
"endcitycode": "BJS",
"endpoint": "T2",
"fjmodel": "空客350(大)",
"fjcode": "359",
"zdl": "100.00",
"can": "有",
"canmsg": "早餐",
"fyear": "机龄10.4年",
"bridge": "航班廊桥率100%",
"adl": "平均延误11分钟",
"clp": "航班取消率7%",
"cot": 20,
"ot": 40,
"jc": 930,
"jczk": 4,
"jcet": 1080,
"jcye": 220,
"jccount": null,
"gc": 2170,
"gczk": 2,
"gcet": 2158,
"gcye": 840
},
{
……更多数据
}
]
}
更新记录
