接口简介:
查询指定日期,地点,终点的航班信息,包括机票票价,航班班次列表,机型,飞行时长,起飞时间等各类信息。注意,调用该接口权限,购买授权后同时必须开通彩钻或炫钻才能调用。【该接口为定制接口,需登录后台购买授权后才能调用。】
请求地址:
https://cn.apihz.cn/api/dingzhi/jipiaolist.php
请求方式:
POST或GET。
请求参数:
【名称】【参数】【必填】【说明】
【用户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】
【cookie】【ck】【否】【cookie】
【查询通道】【type】【否】【1或2,默认1号通道,2号通道返回数据字段较少,不同通道最低价格不一致,但相差无几。例:type=1】
【代理通道】【dl】【否】【0=不使用代理,1=使用平台代理池,扣除5盟点,2=使用独享代理IP,扣除10盟点。一般在查询失败时可以尝试切换代理通道。】
返回参数:
【名称】【参数】【说明】
【状态码】【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】【公务舱最低婴儿价。】
GET请求示例:
https://cn.apihz.cn/api/dingzhi/jipiaolist.php?id=88888888&key=88888888&type=1&star=SHA&end=PEK&stary=2025&starm=12&stard=9&ck=&dl=
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"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
},
{
……更多数据
}
]
}
参考资料(版权):
https://www.apihz.cn/api/dingzhijipiaolist.html