4.1_国内实时航班搜索_idomesticticketshopping

4.1.1请求参数

参数	类型	说明	必填	备注
origin_destinations	Array	航段信息列表	Y
airline	Array	航司集合	N
physical_cabin	String	舱位等级	Y	F:头等舱 C:公务舱 Y:经济舱 W:豪华经济舱
is_search_gwbook	bool	是否需官网价格	N	true/false，默认为false
is_search_rule	bool	是否查询退改条款	N	true/false，默认为true；建议不要在shopping时同步查询退改条款，否则容易因为数据量大导致查询异常，可以异步调用/IDomesticShoppingRuleQueryV2 接口查询
apply_result	bool	是否含需申请价格	N	true/false，默认为true
passengers	Array	乘客清单	Y
is_get_added_value	bool	是否含增值产品	N	true/false，默认为false 单程时有效;

origin_destinations：

参数	类型	说明	必填	备注
departure_city	String	出发地	Y	上海市:SHA2; 虹桥机场:SHA; 浦东机场:PVG
arrival_city	String	目的地	Y	上海市:SHA2; 虹桥机场:SHA; 浦东机场:PVG
departure_date	String	出发日期	Y	YYYY-MM-DD
earlies_time	String	最早出发时间	Y	HH:mm
latest_time	String	最晚出发时间	Y	HH:mm

passengers:

参数	类型	说明	必填	备注
passenger_type	String	乘客类型	Y	可选值：ADT CHD INF
passenger_count	Int	数量	Y

4.1.2请求样例

{
  "origin_destinations": [
    {
            "departure_city": "CAN",
            "arrival_city": "JGS",
            "departure_date": "2018-08-01",
            "earlies_time": "00:00",
            "latest_time": "23:00"
    }
  ],
  "airline": [
    "CZ"
  ],
  "physical_cabin": "",
  "apply_result": false,
  "is_search_gwbook": true,
"passengers":[
     { 
        "passenger_type":"ADT",
        "passenger_count":1
     }
    ]

}

4.1.3返回参数

参数	类型	说明	备注
code	String	是否调用接口成功	20000表示成功，非20000表异常
detail	Object	结果集
description	String	描述	当异常时记录异常信息

detail:

参数	类型	说明	备注
serialNumber	String	缓存key	下单时回传给接口
flightList	Array	行程组
payCurrency	String	币种	20250318 新增预留字段，暂未启用

flightList：

参数	类型	说明
flight_id	String	行程ID 唯一标示，下单时将选择的航班信息ID回传给接口
cabin_fares	Array	舱位信息列表
trips	Array	行程信息列表

cabin_fares：

参数	类型	说明	备注
psg_fares	Array	旅客票价信息列表
cabin	String	舱等代码	F:头等舱 C:公务舱 Y:经济舱 W:豪华经济舱
cabin_name	String	舱等名称
cabin_fare_id	String	舱位id
class_code	String	舱位
sub_class_code	String	子舱位
seat	String	座位数	A则座位数>9 <9则为具体数量
rule_obj	Object	条款
cabin_fare_Number	String	价格序号
valueAddedProducts	String	增值产品	该舱位可能存在的其它增值产品运价说明(多个,号隔开)，此处列出该舱位可能存在的其它增值产品;并非指运价已包括这些增值产品;需再从询价接口获取价格
tripsOrder	String	行程单	无行程单：空值或=“30” 普通:10 中性:20

rule_obj：

参数	类型	说明	备注
rules	Array	退改条款

rules：

参数	类型	说明
change_conditions	String	是否可签转
rule_remark	String	备注
rules_item	Array	退改明细
baggage_allowance	String	行李额
baggage_remark	String	行李额说明

rule_item:

参数	类型	说明	备注
operator_hour_text	String	适用条件
change_price	decimal	同舱改签费
refund_price	decimal	退票费用
hour	String	(起飞前OR起飞后)小时
operator_th	String	对hour的标注	10:距离起飞前hour 20:距离起飞前（含）hour 30:起飞前X小时后hour 40:起飞前X小时后（含）hour
refund_percent	decimal	退票百分比	2024/03/18 新增
change_percent	decimal	改签百分比	2024/03/18 新增
change_price_base	decimal	改签费保底金额	2024/03/18 新增
refund_price_base	decimal	退票保底金额	2024/03/18 新增
cabin_code_base	String	计算退改基础舱位	2024/03/18 新增

psg_fares：

参数	类型	说明	备注
passenger_type	String	乘客类型	ADT:成人 CHD:儿童 INF:婴儿
discount	decimal	折扣	折扣
base_fare	decimal	票面价
airport_tax	decimal	机场建设费
oil_tax	decimal	燃油费
l_reward_fare	decimal	奖励费用
m_commission	decimal	代理费
m_fare	String	奖励
service_fare	decimal	服务费
total_fare	decimal	总价
fare_type	int	运价类型	1：普通 2：航司官网 3：特殊 4：特价
is_need_apply	bool	是否需申请	True：是;需人工跟进 false：否
trips_order	String	行程单	无行程单：空值或=“30” 普通:10 中性:20
trips_order_remark	String	行程单说明
meal	String	餐食	B 早餐 C 免费酒精饮料 D 正餐 F 供采购的食物 G 供采购的食物和饮料 H 热的膳食 K 轻快早餐 L 午餐 M 膳食 N 没有饭食供应 O 冷的膳食 P 供采购的酒精饮料 R 茶点 S 快餐 V 供采购的茶点 10 未知 20 含餐 30 不含餐
serviceinfo	Object	工作时间说明
baggage	String	行李额

service_time：

参数	类型	说明
start_issue_time	String	出票开始工作时间
end_issue_time	String	出票截止工作时间
start_void_time	String	废票开始工作时间
end_void_time	String	废票截止工作时间
start_refund_change_time	String	退改开始工作时间
end_refund_change_time	String	退改截止工作时间

trips:

参数	类型	说明
origin	String	出发地
arrival	String	目的地
flights	Array	航班信息集合

flights：

参数	类型	说明
departure_airport	String	出发机场
departure_date	String	出发日期
departure_time	String	出发时间
arrival_airport	String	到达机场
arrival_date	String	到达日期
arrival_time	String	到达时间
airline	String	航司
flight_number	String	航班号
code_share	Object	共享航班信息
equipment	String	机型
dep_term	String	出发航站楼
arr_term	String	到达航站楼
meal	String	餐食
week	String	星期
stop	String	经停
stopInfos	Array	经停信息
mileages	Int?	里程

code_share：

参数	类型	说明	备注
carrier	String	航司
flight_number	String	航班号

stopInfo：

参数	类型	说明	备注
stop_city	String	经停机场
stop_time	String	经停时间

4.1.4返回样例

{
    "code": "20000",
    "detail": {
        "flightList": [
            {
                "flight_id": 3,
                "cabin_fares": [
                    {
                        "psg_fares": [
                            {
                                "passenger_type": "ADT",
                                "discount": 6.5,
                                "base_fare": 1160,
                                "airport_tax": 50,
                                "oil_tax": 0,
                                "total_fare": "1712",
                                "l_reward_fare": 78,
                                "service_fare": 10,
                                "fare_type": 3,
                                "trips_order": "10",
                                "trips_order_remark": "20元",
                                "is_need_apply": false,
                                "meal": "10",
                                "serviceinfo": {
                                    "service_time": {
                                        "end_issue_time": "10:09:59",
                                        "end_void_time": "23:59:00",
                                        "start_issue_time": "00:00:00",
                                        "start_void_time": "00:00:00",
                                        "end_refund_change_time": "23:59:59",
                                        "start_refund_change_time": "11:00:00"
                                    }
                                }
                            }
                        ],
                        "cabin": "Y",
                        "cabin_fare_id": "01010101_V",
                        "cabin_name": "经济舱",
                        "class_code": "V",
                        "rule_obj": {
                            "rules": [
                                {
                                    "change_conditions": "",
                                    "rule_remark": "",
                                    "rule_item": [],
                                    "baggage_allowance": "",
                                    "baggage_remark": "20kg"
                                }
                            ]
                        },
                        "seat": "A",
                        "sub_class_code": "",
                        "cabin_fare_Number": 0
                    }
                ],
                "trips": [
                    {
                        "origin": "CAN",
                        "arrival": "SHA",
                        "flights": {
                            "airline": "CA",
                            "airline_cnname": "国航",
                            "arr_term": "T2",
                            "arrival_airport": "SHA",
                            "arrival_airport_cnname": "上海虹桥国际机场",
                            "arrival_airport_short_cnname": "上海虹桥国际机场",
                            "arrival_city": "SHA",
                            "arrival_city_cnname": "上海",
                            "arrival_date": "2020-08-31",
                            "arrival_time": "11:20",
                            "code_share": {
                                "carrier": "",
                                "carrier_cnname": null,
                                "flight_number": ""
                            },
                            "dep_term": "T1",
                            "departure_airport": "CAN",
                            "departure_airport_cnname": "广州白云国际机场",
                            "departure_airport_short_cnname": "广州白云国际机场",
                            "departure_city": "CAN",
                            "departure_city_cnname": "广州",
                            "departure_date": "2020-08-31",
                            "departure_time": "08:55",
                            "equipment": "747",
                            "flight_id": "01010101",
                            "flight_number": "1838",
                            "meal": "FS|JS|YR",
                            "stop": 0,
                            "week": "MON"
                        }
                    }
                ]
            }
        ],
        "serialNumber": "f8f412f6-6407-3b43-f9cc-23822590861c"
    }
}

目录

4.1.1请求参数

4.1.2请求样例

4.1.3返回参数

4.1.4返回样例