接口说明
- 按航线获取国内机票票价，以此来做预算管理
1、出发城市和到达城市都需要传入城市id，类型为string。
基本信息
|
HTTP URL |
/api-gateway/g/flight/info/estimatePrice |
|---|---|
|
HTTP Method |
POST |
|
权限要求 |
|
请求头
|
参数名称 |
参数值 |
|---|---|
|
Content-Type |
application/json |
请求参数
|
字段名 |
字段说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
client_id |
申请应用时分配的AppKey |
string |
Y |
|
|
access_token |
授权后的access token |
string |
Y |
|
|
company_id |
企业ID |
string |
Y |
|
|
timestamp |
当前时间戳(精确到秒级) |
int |
Y |
|
|
sign |
签名 |
string |
Y |
|
|
departure_city_id |
出发城市id |
string |
Y |
出发城市id |
|
arrival_city_id |
到达城市id |
string |
Y |
到达城市id |
|
date |
出发时间 |
string |
Y |
出发时间，格式 2024-01-31 |
|
search_type |
中转条件 |
int |
N |
1表示只要直飞，2表示只要中转，3或0或者不传表示全都搜索 |
请求示例
{
"client_id":"client_id_test",
"access_token":"access_token_test",
"company_id":"12345678980",
"timestamp":1583485957,
"sign":"019057df472a3224a1408a3043c5e0a6",
"departure_city_id":"1",
"arrival_city_id":"4",
"date":"2024-01-31",
"search_type":2
}
响应参数
|
字段名 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
errno |
错误编码 |
int |
数字 0 表示成功，非0 表示失败 |
|
errmsg |
错误信息 |
string |
errno=0时为常量"SUCCESS"，errno!=0时为错误信息 |
|
data |
数据 |
object |
具体响应的数据 |
|
data.flight_list |
航班列表 |
array |
|
|
data.flight_list.flight_info |
航班信息 |
object |
|
|
data.flight_list.flight_route_price |
航班的价格信息 |
array |
设计为数组是应对中转航班时，按航班号返回每个航班的预估价格。该数组长度为1，表示直飞；长度为2表示中转 |
flight_info
|
字段名 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
routes |
航班信息-航段 |
array |
航班信息，可为直飞或中转。该数组长度为1，表示直飞；长度为2表示中转 |
|
routes.departure_info |
航段明细-出发信息 |
array |
|
|
routes.arrival_info |
航段明细-到达信息 |
array |
|
|
routes.airline_info |
航段明细-航司信息 |
array |
|
departure_info
|
字段名 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
departure_airport_code |
出发机场三字码 |
string |
出发机场三字码，如PEK |
|
departure_airport_name |
出发机场名称 |
string |
出发机场名称，如 首都机场 |
|
departure_airport_full_name |
出发机场全称 |
string |
出发机场全称，如 北京首都国际机场 |
|
departure_airport_simple_name |
出发机场简称 |
string |
出发机场简称，如 首都 |
|
departure_city_name |
出发城市名 |
string |
出发城市名，如 北京 |
|
departure_terminal |
出发机场航站楼 |
string |
出发机场航站楼，可为空。如 T2 |
|
departure_datetime |
出发日期时间 |
string |
出发日期时间，如 2024-11-25 07:00 |
|
departure_city_id |
出发城市id |
string |
出发城市id，如 1 |
arrival_info
|
字段名 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
arrival_airport_code |
到达机场三字码 |
string |
|
|
arrival_airport_name |
到达机场名称 |
string |
|
|
arrival_airport_full_name |
到达机场全称 |
string |
|
|
arrival_airport_simple_name |
到达机场简称 |
string |
|
|
arrival_city_name |
到达城市名 |
string |
|
|
arrival_terminal |
到达机场航站楼 |
string |
|
|
arrival_datetime |
到达日期时间 |
string |
|
|
arrival_city_id |
到达城市id |
string |
|
airline_info
|
字段名 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
airline_name |
航司名称 |
string |
航司名称，如 中国东方航空股份有限公司 |
|
airline_simple_name |
航司简称 |
string |
航司简称，如 东方航空 |
|
airline_very_simple_name |
航司极简称 |
string |
航司极简称，如 东航 |
|
flight_number |
航班号 |
string |
航班号，如 MU5100 |
flight_route_price
|
字段名 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
flight_number |
航班号 |
string |
航班号，直飞航班可以不关注。中转航班时，与routes数组里的route对象内的airline_info.flight_number 关联，确定每一个中转段对应的价格。 |
|
estimate_first |
头等舱预估价 |
int |
头等舱预估价，单位分，0表示该航班此舱售罄 |
|
estimate_biz |
公务舱预估价 |
int |
公务舱预估价，单位分，0表示该航班此舱售罄 |
|
estimate_eco |
经济舱预估价 |
int |
经济舱预估价，单位分，0表示该航班此舱售罄 |
响应示例
正常示例
{
"errno": 0,
"errmsg": "ok",
"data":
{
"flight_list":
[
{
"flight_info":
{
"routes":
[
{
"departure_info":
{
"departure_airport_code": "PEK",
"departure_airport_name": "首都机场",
"departure_airport_full_name": "北京首都国际机场",
"departure_airport_simple_name": "首都",
"departure_city_name": "北京",
"departure_terminal": "T2",
"departure_datetime": "2024-11-25 07:00",
"departure_city_id": "1"
},
"arrival_info":
{
"arrival_airport_code": "PVG",
"arrival_airport_name": "浦东机场",
"arrival_airport_full_name": "上海浦东国际机场",
"arrival_airport_simple_name": "浦东",
"arrival_city_name": "上海",
"arrival_terminal": "T1",
"arrival_datetime": "2024-11-25 09:15",
"arrival_city_id": "4"
},
"airline_info":
{
"airline_name": "中国东方航空股份有限公司",
"airline_simple_name": "东方航空",
"airline_very_simple_name": "东航",
"flight_number": "MU5100"
}
}
]
},
"flight_route_price_list":
[
{
"flight_number": "MU5100",
"estimate_first": 0,
"estimate_biz": 839000,
"estimate_eco": 215000
}
]
},
{
"flight_info":
{
"routes":
[
{
"departure_info":
{
"departure_airport_code": "PEK",
"departure_airport_name": "首都机场",
"departure_airport_full_name": "北京首都国际机场",
"departure_airport_simple_name": "首都",
"departure_city_name": "北京",
"departure_terminal": "T2",
"departure_datetime": "2024-11-25 07:00",
"departure_city_id": "1"
},
"arrival_info":
{
"arrival_airport_code": "PVG",
"arrival_airport_name": "浦东机场",
"arrival_airport_full_name": "上海浦东国际机场",
"arrival_airport_simple_name": "浦东",
"arrival_city_name": "上海",
"arrival_terminal": "T1",
"arrival_datetime": "2024-11-25 09:15",
"arrival_city_id": "4"
},
"airline_info":
{
"airline_name": "上海吉祥航空股份有限公司",
"airline_simple_name": "吉祥航空",
"airline_very_simple_name": "吉祥",
"flight_number": "HO5353"
}
}
]
},
"flight_route_price_list":
[
{
"flight_number": "HO5353",
"estimate_first": 0,
"estimate_biz": 0,
"estimate_eco": 215000
}
]
},
{
"flight_info":
{
"routes":
[
{
"departure_info":
{
"departure_airport_code": "PEK",
"departure_airport_name": "首都机场",
"departure_airport_full_name": "北京首都国际机场",
"departure_airport_simple_name": "首都",
"departure_city_name": "北京",
"departure_terminal": "T2",
"departure_datetime": "2024-11-25 07:00",
"departure_city_id": "1"
},
"arrival_info":
{
"arrival_airport_code": "PVG",
"arrival_airport_name": "浦东机场",
"arrival_airport_full_name": "上海浦东国际机场",
"arrival_airport_simple_name": "浦东",
"arrival_city_name": "上海",
"arrival_terminal": "T1",
"arrival_datetime": "2024-11-25 09:15",
"arrival_city_id": "4"
},
"airline_info":
{
"airline_name": "厦门航空有限公司",
"airline_simple_name": "厦门航空",
"airline_very_simple_name": "厦航",
"flight_number": "MF3390"
}
}
]
},
"flight_route_price_list":
[
{
"flight_number": "MF3390",
"estimate_first": 0,
"estimate_biz": 0,
"estimate_eco": 215000
}
]
}
]
}
}
错误码
外层错误码
|
错误码 |
说明 |
|---|---|
|
0 |
成功 |
|
|
|
|
|
|
版本记录
|
日期 |
更新人 |
更新内容 |
上线时间 |
|---|---|---|---|
|
2024.11.25 |
陈继诗 |
迁移新建文档 |
2024.11.25 |