接口线路类型一[集群IP接口]
[接口地址1] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址2] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址3] :当前负载【】 接口通讯【正常

复制

测速 

说明:直接访问https://api.apihz.cn/getapi.php获取当前最优接口地址,IP接口省去域名解析步骤,速度较快。集群IP接口并非永久有效,且容易遭受攻击,建议定期获取当前最优IP接口地址做容错处理,或直接使用域名接口或彩钻接口。IP直链接口CC防火墙严格。
接口线路类型二[域名接口]
[接口地址] :[自动分发到集群接口服务器,但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]

复制

测速 

接口线路类型三[VIP线路超高稳定-最低24¥/月]
[VIP线路] :[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。登录后购买。注:VIP线路是指调用接口的线路更有保障以及更高的调用频次限制等,并非收费接口包月使用。]

复制

测速 

请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)

复制全部

复制参数 

[POST]请求示例:(请根据开发语言自行POST,参考【GET/POST教程】。)

请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。参数内容较大的必须用POST,不能GET。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
名称 参数 必填 说明
开发者IDid用户中心的数字ID,例:id=10000000
开发者KEYkey用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2
起点star起点,可以是城市名,机场名,机场代码,如为城市名,尽量别传后缀,如上海市则传上海。标准名称可调用机场代码查询接口【https://www.apihz.cn/api/jiaotongjichangcode.html】。例:star=SHA
终点end终点,可以是城市名,机场名,机场代码,如为城市名,尽量别传后缀,如上海市则传上海。标准名称可调用机场代码查询接口【https://www.apihz.cn/api/jiaotongjichangcode.html】。例:end=PEK
cookieckcookie
代理通道dl0=不使用代理,1=使用平台代理池,扣除5盟点,2=使用独享代理IP,扣除10盟点。一般在查询失败时可以尝试切换代理通道。
动态秘钥dkey开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371
用户IPuip接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。
返回参数说明
名称 参数 说明
状态码code200成功,400错误
消息内容msg消息内容。
起点机场代码starcode起点机场代码。
终点机场代码endcode终点机场代码。
起点城市中文starnamecn起点城市中文。
终点城市中文endnamecn终点城市中文。
起点城市英文starnameen起点城市英文。
终点城市英文endnameen终点城市英文。
起点机场名称starair起点机场名称。
终点机场名称endair终点机场名称。
起点机场简称starairjc起点机场简称。
终点机场简称endairjc终点机场简称。
低价日历数据集datasdj低价日历数据集。
航班日期datasdj.flydate航班日期。
星期几datasdj.week星期几。
当前最低票价datasdj.price当前最低票价。
折扣力度datasdj.discount折扣力度,通常为整数,表示百分比,例如31表示3.1折。
航班号datasdj.flightno航班号。
计划起飞时间datasdj.flytime计划起飞时间。
计划到达时间datasdj.arrtime计划到达时间。
价格类型标识datasdj.pricetype价格类型标识,常见值:1=经济舱,2=公务舱,3=头等舱,4=超级经济舱等。仅供参考。
未知参数datasdj.lowestprice未知参数。
未知参数datasdj.lowestflyspan未知参数。
未知参数datasdj.olowestprice未知参数。
未知参数datasdj.monthlowestprice未知参数。
未知参数datasdj.flightTrainType未知参数。
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
    "code": 200,
    "starcode": "MIG",
    "endcode": "SHA",
    "starnamecn": "绵阳",
    "endnamecn": "上海",
    "starnameen": "ManYang",
    "endnameen": "ShangHai",
    "starair": "南郊机场",
    "endair": "虹桥国际机场",
    "starairjc": "南郊",
    "endairjc": "虹桥",
    "datasdj": [{
        "flydate": "2025-12-06",
        "week": "周六",
        "price": 1600,
        "discount": 90,
        "flightno": "FM9410",
        "flytime": "2025-12-06 10:30",
        "arrtime": "2025-12-06 12:50",
        "pricetype": 1,
        "lowestprice": 0,
        "lowestflyspan": 0,
        "olowestprice": 0,
        "monthlowestprice": 0,
        "flightTrainType": 0
    }, {
        "flydate": "2025-12-07",
        "week": "周日",
        "price": 1302,
        "discount": 73,
        "flightno": "FM9410",
        "flytime": "2025-12-07 11:00",
        "arrtime": "2025-12-07 13:35",
        "pricetype": 1,
        "lowestprice": 0,
        "lowestflyspan": 0,
        "olowestprice": 0,
        "monthlowestprice": 0,
        "flightTrainType": 0
    }, {
        "flydate": "2025-12-08",
        "week": "周一",
        "price": 1282,
        "discount": 72,
        "flightno": "FM9410",
        "flytime": "2025-12-08 11:00",
        "arrtime": "2025-12-08 13:35",
        "pricetype": 1,
        "lowestprice": 0,
        "lowestflyspan": 0,
        "olowestprice": 0,
        "monthlowestprice": 0,
        "flightTrainType": 0
    }, {
        "flydate": "2025-12-09",
        "week": "周二",
        "price": 864,
        "discount": 49,
        "flightno": "FM9410",
        "flytime": "2025-12-09 11:00",
        "arrtime": "2025-12-09 13:35",
        "pricetype": 1,
        "lowestprice": 0,
        "lowestflyspan": 0,
        "olowestprice": 0,
        "monthlowestprice": 0,
        "flightTrainType": 0
    }, {
        "flydate": "2025-12-10",
        "week": "周三",
        "price": 625,
        "discount": 35,
        "flightno": "FM9410",
        "flytime": "2025-12-10 11:00",
        "arrtime": "2025-12-10 13:35",
        "pricetype": 1,
        "lowestprice": 0,
        "lowestflyspan": 0,
        "olowestprice": 0,
        "monthlowestprice": 0,
        "flightTrainType": 0
    }, {
        "flydate": "2025-12-11",
        "week": "周四",
        "price": 483,
        "discount": 27,
        "flightno": "FM9410",
        "flytime": "2025-12-11 10:30",
        "arrtime": "2025-12-11 12:50",
        "pricetype": 1,
        "lowestprice": 0,
        "lowestflyspan": 0,
        "olowestprice": 0,
        "monthlowestprice": 0,
        "flightTrainType": 0
    }, {
	……更多数据
	}]
}
更新记录
2025-12-05 19:57:13 - 新增接口。

 定制接口-机票查询-低价日历-2025-12-11 18:03:46

查询两个月内机票航班低价日历。【该接口为定制接口,需登录后台购买授权后才能调用。】

调用限制
调用权限 定制接口需后台付费授权
单价/次 免费[无上限]
单日[所有用户之和] 999999999
1分钟并发[所有用户之和] 2000
1小时并发[所有用户之和] 999999999
频次限制[注册用户] 10次/分钟|每日无上限
频次限制[钻石会员] 最高8000+次/分钟|每日无上限
频次限制[定制频次] 联系我们定制
调用方法
请求方式 GET/POST
返回格式 JSON
编码格式 UTF-8
调用信息
浏览量 249
今日总计调用 0
昨日总计调用 0
历史总计调用 60
今日排名 370
总排名 393
自检信息
自检启用状态 未开启
自检节点 /
自检线路 彩钻接口线路
自检时间 /
自检耗时 / 毫秒
自检状态 /
历史自检成功数 / 次
历史自检失败数 / 次
历史自检成功率 / %
今日自检成功数 / 次
今日自检失败数 / 次
今日自检成功率 / %
定制接口-相关接口