接口名字
- 接口:common/flight/stats
- Method:GET
- 数据格式:JSON
- 限流信息:3000次/小时
- 接口说明:查询两个城市之间的航班飞行时间和参考价格,供比较的定制规则开发和校验。需要注意trip_time单位是秒,金额需要与币种联合看,目前基本都是人民币金额,主要支持的也是国内航班。需要注意,出发到达城市只支持产品标准城市的城市代码,自定义城市的不支持。
- 变更历史
参数:
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
bizId |
String |
业务唯一识别码 |
TRUE |
255 |
timestamp |
Long |
时间戳 |
TRUE |
无 |
from_city_code |
String |
出发城市代码,需要注意国内城市基本是中文,但是 海外的很多是英文代码 |
TRUE |
无 |
to_city_code |
String |
到达城市代码 |
TRUE |
无 |
返回参数
字段名称 |
字段类型 |
字段描述 |
resCode |
Integer |
响应状态码(见附录) |
resMsg |
String |
响应描述信息 |
data |
JSON |
城市间推荐价格信息 |
data.from_city_code |
String |
出发城市代码 |
data.from_city_name |
String |
出发城市名字 |
data.to_city_code |
String |
到达城市代码 |
data.to_city_name |
String |
到达城市名字 |
data.standard_price |
BigDecimal |
标准参考价,即全服务航空的经济舱全价 |
data.currency_code |
String |
标准参考价的币种,比如CNY |
data.trip_time |
Integer |
飞行的时长,秒 |
示例:
请求数据
common/flight/stats?from_city=上海&to_city=北京
返回数据
{
"resCode": 200000,
"resMsg": "success",
"data": {
"from_city_code": "北京",
"from_city_name": "北京市",
"to_city_code": "上海",
"to_city_name": "上海市",
"standard_price": 1690,
"currency_code": "CNY",
"trip_time": 7600
}
}
变更历史
变更日期 |
变更人 |
变更描述 |
2025-03-23 |
陈波 |
新建 |