| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者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 |
| 代理通道 | 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 | 消息内容。 |
| 起点机场代码 | 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 - 新增接口。
查询两个月内机票航班低价日历。【该接口为定制接口,需登录后台购买授权后才能调用。】
| 调用权限 | 定制接口需后台付费授权 |
| 单价/次 | 免费[无上限] |
| 单日[所有用户之和] | 999999999 |
| 1分钟并发[所有用户之和] | 2000 |
| 1小时并发[所有用户之和] | 999999999 |
| 频次限制[注册用户] | 10次/分钟|每日无上限 |
| 频次限制[钻石会员] | 最高8000+次/分钟|每日无上限 |
| 频次限制[定制频次] | 联系我们定制 |
| 浏览量 | 249 |
| 今日总计调用 | 0 |
| 昨日总计调用 | 0 |
| 历史总计调用 | 60 |
| 今日排名 | 370 |
| 总排名 | 393 |
| 自检启用状态 | 未开启 |
| 自检节点 | / |
| 自检线路 | 彩钻接口线路 |
| 自检时间 | / |
| 自检耗时 | / 毫秒 |
| 自检状态 | / |
| 历史自检成功数 | / 次 |
| 历史自检失败数 | / 次 |
| 历史自检成功率 | / % |
| 今日自检成功数 | / 次 |
| 今日自检失败数 | / 次 |
| 今日自检成功率 | / % |