3.1实时航班搜索(ITicketShoppingV2)
参数 | 类型 | 说明 | 必填 | 备注 |
---|---|---|---|---|
isDirection | String | 飞行偏好 | Y | 0=不限 1=直飞 2=最大中转1次 3=最大中转2次 |
airline | String | 航司 | N | 可以传入多个,用逗号隔开 |
cabinType | String | 舱位等级 | Y | 0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱 |
adultNumber | Int | 成人数量 | Y | |
childNumber | Int | 儿童数量 | N | |
infantNumber | Int | 婴儿数量 | N | |
studentNumber | Int | 学生数量 | N | |
isAsync | Int | 是否异步 | N | 使用3.14异步请求时 传1 返回serialNumber |
specification | String | 产品规则 | N | 0不限 1可退 2可改 3可退可改 4含行李 |
isMix | Int | 是否允许混仓 | N | |
isItinerary | Int | 是否包含行程单 | N | |
odList | Array | 航段信息集合 | Y | |
| Int | 经停城市机场信息 | N | 已停用 |
includeNDC | String | 是否包含NDC信息 | N | 20210813新增 如不指定则默认0,不包含 自2024/07/03日起 此字段已不支持 |
odList:
参数 | 说明 | 必填 | 备注 |
---|---|---|---|
departureCode | 出发城市编码 | Y | |
destinationCode | 到达城市编码 | Y | |
departureDate | 出发日期 | Y | 格式:yyyy-MM-dd |
{ "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 }
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
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 | 扩展信息 | |
groupTag | Bool | true代表该运价为小团价产品 若退改废必须全部旅客一起申请 | 20230921新增 |
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新增 产品类型:官网、自营、合作商、NDC |
sellAdditionRebateRate | String | 促销返点 | |
sellAdditionRebateMoneyTotalCNY | String | 促销直减金额 | |
sellRebatePointFareCNY | String | 促销合计金额 | |
brand | ObjectArray | 品牌信息 | |
limitingCondition | Object | 乘客限制条件 | 202408新增 |
farerule | ObjectArray | 条款规则 | 202411新增 |
brand
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
brandCode | String | 品牌编号 | |
brandName | String | 品牌名称 | |
brandNameCh | String | 品牌名称(中文) |
farerule
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
origin | String | 出发地三字码 | |
destination | String | 目的地三字码 | |
refund | ObjectArray | 退款规则 | |
change | ObjectArray | 改签规则 | |
luggages | ObjectArray | 行李规定 |
refund
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
typeCode | String | 退票类型,返值[before or after] | |
statusCode | String | 退票标识 T:不可退 H:有条件退 F:允许 P:允许,可能收取费用 |
change
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
typeCode | String | 改签类型,返值[before or after] | |
statusCode | String | 改签标识 T:不可改 H:有条件改 F:允许 P:允许,可能收取费用 |
luggages
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
airline | String | 航司 | |
flightNo | String | 航班号 | |
fareBasisCode | String | fareBasisCode | |
luggage | ObjectArray | 行李 |
luggage
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
baggageCarryon | Object | 手提行李 | |
baggageChecked | Object | 托运行李 |
baggageCarryon
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
pieces | String | 行李件数 | |
weight | String | 行李重量 | |
demision | String | 行李体积 | |
description | String | 行李描述 |
baggageChecked
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
pieces | String | 行李件数 | |
weight | String | 行李重量 | |
demision | String | 行李体积 | |
description | String | 行李描述 |
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 | 经停机场码 | |
cabinType | String | 舱位等级 | 0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱 |
refs
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
fare_basis_code | String | 运价基础 | 默认第一位乘客类型fb |
free_baggage_allowance | String | 行李信息 | |
origin | String | 出发机场 | |
destination | String | 到达机场 | |
luggage | ObjectArray | 行李额相关信息 |
luggage
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
passengerType | INT | 乘客类型 | 0:成人 1:儿童 2:婴儿 |
luggage | ObjectArray | 行李额信息明细 | |
fareBasisCode | String | 运价基础 | 当前乘客类型的fb |
luggage
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
baggageCarryon | OBJECT | 手持行李 | |
baggageChecked | OBJECT | 托运行李 |
baggageCarryon && baggageChecked
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
pieces | STRING | 行李件数 | |
weight | STRING | 行李重量 | |
demision | STRING | 行李体积 | |
description | STRING | 描述 |
limitingCondition
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
nationalityOrArea | Object | 国籍/地区限制 | |
certificate | Object | 证件限制 | |
availableAge | Object | 年龄限制 | |
availablePassagerCount | Object | 人数限制 |
nationalityOrArea/certificate
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
isAllow | Boolean | 是否允许 | true:则允许codes的国籍/地区(证件类型) false:则禁止codes的国籍/地区(证件类型) |
codes | Array | 国家/地区二字码(证件类型参考下单IDType) | 该参数有值时isAllow有效 |
names | Array | 国家/地区(证件类型)中文名称 |
availableAge
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
minAge | Int | 最小年龄限制 | 默认值:-1(无限制) |
maxAge | Int | 最大年龄限制 | 默认值:-1(无限制) |
availablePassagerCount
参数 | 类型 | 说明 | 备注 | |
---|---|---|---|---|
minCount | Int | 最小人数限制 | 默认值:-1(无限制) | |
maxCount | Int | 最大人数限制 | 默认值:-1(无限制) | |
beEvenNumber | Boolean | 是否偶数人数限制 |
RCVServiceFee
参数 | 类型 | 说明 | 备注 |
---|---|---|---|
ChangeFeeCNY | Float | 改签加收服务费 | 无数据则以退票时为准 |
RefundFeeCNY | Float | 退票加收服务费 | 无数据则以退票时为准 |
VoidFeeCNY | Float | 废票加收服务费 | 无数据则以退票时为准 |
{ "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", "cabinType": "0", "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":[ ] } ] } ] } ] } }