Skip to content

机票-详情

基本信息

Path: /flight/detail

Method: POST

Headers

参数名称参数值是否必须示例备注
Content-Typeapplication/json
x-lvcang-api-account开放平台分配aaa.test

Body

名称类型是否必须备注
adultNuminteger必须成人人数 目前只支持成人,乘客人总数最多不超过9人
depDatestring必须起飞时间 格式:YYYY-MM-DD
airlinestring必须航司二字码
flightNostring必须航班号
cabinCodestring必须舱位
depAirportstring必须出发机场三字码
arrAirportstring必须到达机场三字码

返回数据

名称类型是否必须备注
codestring必须状态码 0-成功 3000-失败 5000-请求异常
messagestring必须返回信息
successboolean必须请求是否成功
dataobject非必须返回内容
├─ datastring非必须可保存必要信息,之后生单按原值回传。最大 50 个字符
├─ productTagstring非必须产品标签 1 普通产品(快速出票,标准退改签);3 特惠产品(保障出行);4、官网产品(官网直营,标准退改);5 特殊产品(个性产品,保障出行);10自营产品(快速出票,标准退改);
├─ priceListobject非必须
├─ typeinteger非必须乘客类型 0:未知, 1:成人, 2:儿童, 3:婴儿
├─ discountnumber非必须折扣
├─ salePricenumber非必须基本销售价,人民币
├─ taxnumber非必须机建费+燃油费
├─ yqnumber非必须燃油费(整数)
├─ taxFeenumber非必须机建费
├─ amountinteger非必须成人数量
├─ totalSalePricenumber非必须总销售价
├─ segmentTypeinteger非必须1:去程;2: 返程,暂不支持返程
├─ segmentIndexinteger非必须行程序号,全局序号从1开始计数
├─ marketingAirlinestring非必须航司 IATA 二字码,必须与 flightNumber 航司相同
├─ marketingFlightNostring非必须航班号 如:CA123
├─ cabinCodestring非必须舱位
├─ cabinClassstring非必须舱等 头等:F,商务:C,超经:S,经济:Y
├─ cabinClassStrstring非必须舱等描述
├─ depCitystring非必须出发城市三字码
├─ depCityNamestring非必须出发城市名称
├─ depAirportstring非必须出发机场三字码
├─ depAirportNamestring非必须出发机场名称
├─ depAirportTermstring非必须出发航站楼 使用简写,例如T1
├─ arrCitystring非必须到达城市三字码
├─ arrCityNamestring非必须到达城市名称
├─ arrAirportstring非必须到达机场 IATA 三字码
├─ arrAirportNamestring非必须到达机场名称
├─ arrAirportTermstring非必须抵达航站楼 使用简写,例如T1
├─ depDateTimestring非必须起飞时间
├─ arrDateTimestring非必须到达时间
├─ flightShareboolean非必须共享航班标识 false 非共享 true 共享
├─ aircraftstring非必须机型 如738
├─ shortNamestring非必须航空公司短名称
├─ logoNameUrlstring非必须航司LOGO(带航司名)路径
├─ aircraftNamestring非必须机型名称
├─ aircraftTypeinteger非必须机型类型 1-小型飞机;2-中型飞机;3-大型飞机
├─ refundChangeInfoobject非必须退改规则信息
├─ refundChangeRulesobject []非必须退改信息
├─ ruleTypestring非必须1 退票; 2 改期
├─ allowedstring非必须是否允许退票/改期 0-不允许 1-允许 2-以航司为准
├─ passengerTypestring非必须乘客类型 ADT-成人,CHD-儿童,INF-婴儿
├─ timeRangestring非必须时间段 如果没有定义时间段则为””.常见类似返回值为下面的几种:”2018-11-11 00:00:00前”,”2018-11-11 00:00:00至2018-11-12 03:00:00”,”2018-11-12 03:00:00后”,””
├─ startPointinteger非必须时间段开始点 比如: 退规定义时飞前12小时, 返回值则是 -12
├─ includeStartPointboolean非必须是否包含开始时间 true/false比如:退规定义, 起飞前12小时(含)之前提出,每次变更收取票面价30%作为变更费
├─ endpointinteger非必须时间段结束点 比如: 退规定义时飞后12小时, 返回值则是12
├─ includeEndPointboolean非必须是否包含结束时间 true/false,比如: 退规定义, 起飞后12小时(不含)内及起飞后提出,每次变更收取票面价40%作为变更费”
├─ feenumber非必须根据公式计算出的费用. 例如 50.0 默认0
├─ currencystring非必须默认CNY
├─ feeDescstring非必须收费标准(有可能有小数) 默认””格式化fee字段后, 展示出来的文案:有费用时(fee>0): “¥50.00/人”,无费用(fee=0): “免费”
├─ percentnumber非必须当前时间段定义的计算公式中解析出来的退票百分比(乘以100后的值) 默认0
├─ refundTextstring非必须退票文本信息
├─ changeTextstring非必须改签文本信息
├─ remarkstring非必须其他备注信息
├─ baggageInfoobject非必须行李信息
├─ baggageTextstring非必须行李文本,上海-北京:成人,托运,每人1件,每件23KG,每件长宽高之和<=158CM
├─ carryOnBaggageobject []非必须手提行李额
├─ passengerTypestring非必须乘客类型 ADT/CHD/INF
├─ rulesobject []非必须各个航段的行李额信息
├─ segmentIndexinteger非必须该行李额适用的航段segmentIndex,对应请求航段中的index
├─ freePiecesstring非必须行李件数,PC
├─ weightTypeinteger非必须重量类型,1: 单件重量, 2:总重量
├─ weightstring非必须行李重量
├─ volumestring非必须行李的体积
├─ checkedBaggageobject []非必须托运行李额
├─ passengerTypestring非必须乘客类型 ADT/CHD/INF
├─ rulesobject []非必须各个航段的行李额信息
├─ segmentIndexinteger非必须该行李额适用的航段segmentIndex,对应请求航段中的index
├─ freePiecesstring非必须行李件数,PC
├─ weightTypeinteger非必须重量类型,1: 单件重量, 2:总重量
├─ weightstring非必须行李重量
├─ volumestring非必须行李的体积
├─ limitInfoobject非必须限制信息
├─ maxPersonCountinteger非必须人数上限(小团票必须有值)
├─ minPersonCountstring非必须人数下限(小团票必须有值)
├─ agePairsobject []非必须agePairs
├─ mininteger非必须最小年龄
├─ maxinteger非必须最大年龄
├─ passengerQualificationstring非必须乘客资质:NML成人 STU留学生
├─ groupQualificationstring非必须团体资质:NML普通票 SGT小团票
├─ credentialTypestring非必须证件类型 0:不限 1:身份证 2:签证 3:护照 4:军官证 5:回乡证 6:港澳通行证 7:台胞证;8:台湾通行证 9:海员证 10:户口簿 11:外国人永久居留证 12:港澳居住证 13:台湾居民居住证
├─ idcardPrefixstring非必须身份证开头
├─ invoiceTypestring非必须报销凭证(0 行程单 1 发票 2 行程单+差额发票 3不提供)