3.1_实时航班搜索_国际机票_iticketshoppingv2

3.1.1请求参数

参数	类型	说明	必填	备注
isDirection	String	飞行偏好	Y	0=不限 1=直飞 2=中转
airline	String	航司	N	可以传入多个，用逗号隔开
cabinType	String	舱位等级	Y	0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱
adultNumber	Int	成人数量	Y
childNumber	Int	儿童数量	N
infantNumber	Int	婴儿数量	N
odList	Array	航段信息集合	Y
~~stopOverStyle~~	Int	经停城市机场信息	N	已停用
includeNDC	String	是否包含NDC信息	N	20210813新增如不指定则默认0，不包含自2024/07/03日起此字段已不支持

odList：

参数	说明	必填	备注
departureCode	出发城市编码	Y
destinationCode	到达城市编码	Y
departureDate	出发日期	Y	格式：yyyy-MM-dd

3.1.2请求样例

单程

{
    "isDirection":"0",
    "airline":"",
    "cabinType":"0",
    "odList":[
        {
            "departureCode":"CAN",
            "destinationCode":"SIN",
            "departureDate":"2016-10-01"
        }
    ],
    "adultNumber":1,
    "childNumber":0,
    "infantNumber":0
}

往返

{
    "isDirection":"0",
    "airline":"",
    "cabinType":"0",
    "odList":[
        {
            "departureCode":"CAN",
            "destinationCode":"SIN",
            "departureDate":"2016-10-01"
        },
        {
            "departureCode":"SIN",
            "destinationCode":"CAN",
            "departureDate":"2016-11-01"
        }
    ],
    "adultNumber":1,
    "childNumber":0,
    "infantNumber":0
}

多程

{
    "isDirection":"0",
    "airline":"",
    "cabinType":"0",
    "odList":[
        {
            "departureCode":"CAN",
            "destinationCode":"SIN",
            "departureDate":"2016-10-01"
        },
        {
            "departureCode":"HKG",
            "destinationCode":"BKK",
            "departureDate":"2016-10-20"
        },
        {
            "departureCode":"BKK",
            "destinationCode":"CAN",
            "departureDate":"2016-11-01"
        }
    ],
    "adultNumber":1,
    "childNumber":1,
    "infantNumber":1
}

3.1.3返回参数

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

detail:

参数	类型	说明	备注
serialNumber	String	缓存key	下单时回传给接口
flightDetailList	Array	行程组
payCurrency	String	付款币种	客人支付订单时的币种 20250318 新增

flightDetailList：

参数	类型	说明	备注
flightID	String	行程ID 唯一标示，下单时将选择的航班信息ID回传给接口
airline	String	航司	NDC产品计价时必须使用此字段作为计价接口的airline入参
airline_cn	String	航司中文名
financeDetail	Object	价格详情
tripList	Array	行程信息集合

financeDetail：

参数	类型	说明	备注
officeNumber	String	出票OFFICE
airline	String	出票航司
agencyPolicyRemark	String	代理费政策限制
rewardPolicyRemark	String	奖励政策限制
financeList	Array	价格组	每种乘客类型一条数据
refs	Array	扩展信息
RCVServiceFee	Object	退改废服务费 20241017新增

financeList：

参数	类型	说明	备注
passengerType	String	乘客类型	0成人 1儿童 2婴儿
salePrice	String	票面价
tax	String	税金
beforeReturn	String	代理费点数

beforeReturnPrice	String	代理费金额
afterReturnPrice	String	奖励金额
serviceFee	String	服务费
saleTotal	String	结算价
travelItinerary	String	是否有行程单	0：无 1：有
beforeReturnMoney	String	代理费直减金额
afterReturMoney	String	奖励直减金额
productType	String	产品类型	20210813新增产品类型:BSP、NDC、合作商

tripList

参数	类型	说明
departureCode	String	出发地
destinationCode	String	目的地
flightList	Array	航班信息集合

flightList：

参数	类型	说明	备注
airline	String	航司编码
airlineName	String	航司名
flightNo	String	航班号
classNo	String	舱位
departureCityName	String	出发城市
destinationCityName	String	到达城市
departureCityCode	String	出发城市编码
destinationCityCode	String	到达城市编码
departureAirportCode	String	出发机场编码
destinationAirportCode	String	到达机场编码
departureAirportName	String	出发机场名
destinationAirportName	String	到达机场名
departureDateTime	String	出发日期时间
arrivalDateTime	String	到达日期时间
seatNumber	String	剩余座位数	A:>9 9:>=9 1-8:对应具体数量
equipment	String	机型
departureTerm	String	出发机场航站楼
destinationTerm	String	到达机场航站楼
duration	String	飞行时长	HH:mm
codeShare	String	共享航班
stopOver	Array	经停机场码

refs

参数	类型	说明
fare_basis_code	String	运价基础
free_baggage_allowance	String	行李信息
origin	String	出发机场
destination	String	到达机场

RCVServiceFee

参数	类型	说明	备注
ChangeFeeCNY	Float	改签加收服务费	无数据则以退票时为准
RefundFeeCNY	Float	退票加收服务费	无数据则以退票时为准
VoidFeeCNY	Float	废票加收服务费	无数据则以退票时为准

3.1.4返回样例

{
    "code":"20000",
    "detail":{
        "serialNumber":"c36d6c9f1e054618a61edba5510e52d5",
        "flightDetailList":[
            {
                "flightID":"b8ac217c60398342",
                "airline":"CZ",
                "airline_cn":"南方航空",
                "financeDetail":{
                    "officeNumber":"SIA227",
                    "airline":"CZ",
                    "agencyPolicyRemark":"",
                    "rewardPolicyRemark":",",
                    "financeList":[
                        {
                            "passengerType":"0",
                            "salePrice":"2990",
                            "tax":"683",
                            "beforeReturn":"0",
                            "afterReturn":"0.5",
                            "beforeReturnPrice":"0",
                            "afterReturnPrice":"15",
                            "serviceFee":"0",
                            "saleTotal":"3658",
                            "fare_type":"Published",
                            "refs" : 
                            [
                                {
                                    "fare_basis_code" : "MOWCN",
                                    "free_baggage_allowance" : "30K",
                                    "origin":"WUH",
                                    "destination":"KHH",
								},
								{
                                    "fare_basis_code" : "OOWPROMO",
                                    "free_baggage_allowance" : "30K",
                                    "origin":"TPE",
                                    "destination":"CAN"
								}
							]

                        }
                    ]
                },
                "tripList":[
                    {
                        "departureCode":"WUH",
                        "destinationCode":"KHH",
                        "flightList":[
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"3093",
                                "classNo":"K",
                                "departureCityName":"武汉",
                                "destinationCityName":"高雄",
                                "departureCityCode":"WUH",
                                "destinationCityCode":"KHH",
                                "departureAirportCode":"WUH",
                                "destinationAirportCode":"KHH",
                                "departureAirportName":"武汉天河国际机场",
                                "destinationAirportName":"高雄国际机场",
                                "departureDateTime":"2019-01-31 14:30",
                                "arrivalDateTime":"2019-01-31 17:15",
                                "seatNumber":"A",
                                "duration":"02:45",
                                "equipment":"737",
                                "departureTerm":"T3",
                                "destinationTerm":"",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            }
                        ]
                    },
                    {
                        "departureCode":"TPE",
                        "destinationCode":"WUH",
                        "flightList":[
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"3098",
                                "classNo":"Q",
                                "departureCityName":"台北",
                                "destinationCityName":"广州",
                                "departureCityCode":"TPE",
                                "destinationCityCode":"CAN",
                                "departureAirportCode":"TPE",
                                "destinationAirportCode":"CAN",
                                "departureAirportName":"台湾桃园国际机场",
                                "destinationAirportName":"广州白云国际机场",
                                "departureDateTime":"2019-02-07 14:35",
                                "arrivalDateTime":"2019-02-07 17:00",
                                "seatNumber":"4",
                                "duration":"02:25",
                                "equipment":"330",
                                "departureTerm":"2",
                                "destinationTerm":"T2",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            },
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"6589",
                                "classNo":"Q",
                                "departureCityName":"广州",
                                "destinationCityName":"武汉",
                                "departureCityCode":"CAN",
                                "destinationCityCode":"WUH",
                                "departureAirportCode":"CAN",
                                "destinationAirportCode":"WUH",
                                "departureAirportName":"广州白云国际机场",
                                "destinationAirportName":"武汉天河国际机场",
                                "departureDateTime":"2019-02-07 19:25",
                                "arrivalDateTime":"2019-02-07 21:25",
                                "seatNumber":"A",
                                "duration":"02:00",
                                "equipment":"737",
                                "departureTerm":"T2",
                                "destinationTerm":"T3",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

目录

3.1.1请求参数

3.1.2请求样例

单程

往返

多程

3.1.3返回参数

3.1.4返回样例