机票-详情
基本信息
Path: /flight/detail
Method: POST
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | ||
| x-lvcang-api-account | 开放平台分配 | 是 | aaa.test |
Body
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| adultNum | integer | 必须 | 成人人数 目前只支持成人,乘客人总数最多不超过9人 |
| depDate | string | 必须 | 起飞时间 格式:YYYY-MM-DD |
| airline | string | 必须 | 航司二字码 |
| flightNo | string | 必须 | 航班号 |
| cabinCode | string | 必须 | 舱位 |
| depAirport | string | 必须 | 出发机场三字码 |
| arrAirport | string | 必须 | 到达机场三字码 |
返回数据
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | string | 必须 | 状态码 0-成功 3000-失败 5000-请求异常 |
| message | string | 必须 | 返回信息 |
| success | boolean | 必须 | 请求是否成功 |
| data | object | 非必须 | 返回内容 |
| ├─ data | string | 非必须 | 可保存必要信息,之后生单按原值回传。最大 50 个字符 |
| ├─ productTag | string | 非必须 | 产品标签 1 普通产品(快速出票,标准退改签);3 特惠产品(保障出行);4、官网产品(官网直营,标准退改);5 特殊产品(个性产品,保障出行);10自营产品(快速出票,标准退改); |
| ├─ priceList | object | 非必须 | |
| ├─ type | integer | 非必须 | 乘客类型 0:未知, 1:成人, 2:儿童, 3:婴儿 |
| ├─ discount | number | 非必须 | 折扣 |
| ├─ salePrice | number | 非必须 | 基本销售价,人民币 |
| ├─ tax | number | 非必须 | 机建费+燃油费 |
| ├─ yq | number | 非必须 | 燃油费(整数) |
| ├─ taxFee | number | 非必须 | 机建费 |
| ├─ amount | integer | 非必须 | 成人数量 |
| ├─ totalSalePrice | number | 非必须 | 总销售价 |
| ├─ segmentType | integer | 非必须 | 1:去程;2: 返程,暂不支持返程 |
| ├─ segmentIndex | integer | 非必须 | 行程序号,全局序号从1开始计数 |
| ├─ marketingAirline | string | 非必须 | 航司 IATA 二字码,必须与 flightNumber 航司相同 |
| ├─ marketingFlightNo | string | 非必须 | 航班号 如:CA123 |
| ├─ cabinCode | string | 非必须 | 舱位 |
| ├─ cabinClass | string | 非必须 | 舱等 头等:F,商务:C,超经:S,经济:Y |
| ├─ cabinClassStr | string | 非必须 | 舱等描述 |
| ├─ depCity | string | 非必须 | 出发城市三字码 |
| ├─ depCityName | string | 非必须 | 出发城市名称 |
| ├─ depAirport | string | 非必须 | 出发机场三字码 |
| ├─ depAirportName | string | 非必须 | 出发机场名称 |
| ├─ depAirportTerm | string | 非必须 | 出发航站楼 使用简写,例如T1 |
| ├─ arrCity | string | 非必须 | 到达城市三字码 |
| ├─ arrCityName | string | 非必须 | 到达城市名称 |
| ├─ arrAirport | string | 非必须 | 到达机场 IATA 三字码 |
| ├─ arrAirportName | string | 非必须 | 到达机场名称 |
| ├─ arrAirportTerm | string | 非必须 | 抵达航站楼 使用简写,例如T1 |
| ├─ depDateTime | string | 非必须 | 起飞时间 |
| ├─ arrDateTime | string | 非必须 | 到达时间 |
| ├─ flightShare | boolean | 非必须 | 共享航班标识 false 非共享 true 共享 |
| ├─ aircraft | string | 非必须 | 机型 如738 |
| ├─ shortName | string | 非必须 | 航空公司短名称 |
| ├─ logoNameUrl | string | 非必须 | 航司LOGO(带航司名)路径 |
| ├─ aircraftName | string | 非必须 | 机型名称 |
| ├─ aircraftType | integer | 非必须 | 机型类型 1-小型飞机;2-中型飞机;3-大型飞机 |
| ├─ refundChangeInfo | object | 非必须 | 退改规则信息 |
| ├─ refundChangeRules | object [] | 非必须 | 退改信息 |
| ├─ ruleType | string | 非必须 | 1 退票; 2 改期 |
| ├─ allowed | string | 非必须 | 是否允许退票/改期 0-不允许 1-允许 2-以航司为准 |
| ├─ passengerType | string | 非必须 | 乘客类型 ADT-成人,CHD-儿童,INF-婴儿 |
| ├─ timeRange | string | 非必须 | 时间段 如果没有定义时间段则为””.常见类似返回值为下面的几种:”2018-11-11 00:00:00前”,”2018-11-11 00:00:00至2018-11-12 03:00:00”,”2018-11-12 03:00:00后”,”” |
| ├─ startPoint | integer | 非必须 | 时间段开始点 比如: 退规定义时飞前12小时, 返回值则是 -12 |
| ├─ includeStartPoint | boolean | 非必须 | 是否包含开始时间 true/false比如:退规定义, 起飞前12小时(含)之前提出,每次变更收取票面价30%作为变更费 |
| ├─ endpoint | integer | 非必须 | 时间段结束点 比如: 退规定义时飞后12小时, 返回值则是12 |
| ├─ includeEndPoint | boolean | 非必须 | 是否包含结束时间 true/false,比如: 退规定义, 起飞后12小时(不含)内及起飞后提出,每次变更收取票面价40%作为变更费” |
| ├─ fee | number | 非必须 | 根据公式计算出的费用. 例如 50.0 默认0 |
| ├─ currency | string | 非必须 | 默认CNY |
| ├─ feeDesc | string | 非必须 | 收费标准(有可能有小数) 默认””格式化fee字段后, 展示出来的文案:有费用时(fee>0): “¥50.00/人”,无费用(fee=0): “免费” |
| ├─ percent | number | 非必须 | 当前时间段定义的计算公式中解析出来的退票百分比(乘以100后的值) 默认0 |
| ├─ refundText | string | 非必须 | 退票文本信息 |
| ├─ changeText | string | 非必须 | 改签文本信息 |
| ├─ remark | string | 非必须 | 其他备注信息 |
| ├─ baggageInfo | object | 非必须 | 行李信息 |
| ├─ baggageText | string | 非必须 | 行李文本,上海-北京:成人,托运,每人1件,每件23KG,每件长宽高之和<=158CM |
| ├─ carryOnBaggage | object [] | 非必须 | 手提行李额 |
| ├─ passengerType | string | 非必须 | 乘客类型 ADT/CHD/INF |
| ├─ rules | object [] | 非必须 | 各个航段的行李额信息 |
| ├─ segmentIndex | integer | 非必须 | 该行李额适用的航段segmentIndex,对应请求航段中的index |
| ├─ freePieces | string | 非必须 | 行李件数,PC |
| ├─ weightType | integer | 非必须 | 重量类型,1: 单件重量, 2:总重量 |
| ├─ weight | string | 非必须 | 行李重量 |
| ├─ volume | string | 非必须 | 行李的体积 |
| ├─ checkedBaggage | object [] | 非必须 | 托运行李额 |
| ├─ passengerType | string | 非必须 | 乘客类型 ADT/CHD/INF |
| ├─ rules | object [] | 非必须 | 各个航段的行李额信息 |
| ├─ segmentIndex | integer | 非必须 | 该行李额适用的航段segmentIndex,对应请求航段中的index |
| ├─ freePieces | string | 非必须 | 行李件数,PC |
| ├─ weightType | integer | 非必须 | 重量类型,1: 单件重量, 2:总重量 |
| ├─ weight | string | 非必须 | 行李重量 |
| ├─ volume | string | 非必须 | 行李的体积 |
| ├─ limitInfo | object | 非必须 | 限制信息 |
| ├─ maxPersonCount | integer | 非必须 | 人数上限(小团票必须有值) |
| ├─ minPersonCount | string | 非必须 | 人数下限(小团票必须有值) |
| ├─ agePairs | object [] | 非必须 | agePairs |
| ├─ min | integer | 非必须 | 最小年龄 |
| ├─ max | integer | 非必须 | 最大年龄 |
| ├─ passengerQualification | string | 非必须 | 乘客资质:NML成人 STU留学生 |
| ├─ groupQualification | string | 非必须 | 团体资质:NML普通票 SGT小团票 |
| ├─ credentialType | string | 非必须 | 证件类型 0:不限 1:身份证 2:签证 3:护照 4:军官证 5:回乡证 6:港澳通行证 7:台胞证;8:台湾通行证 9:海员证 10:户口簿 11:外国人永久居留证 12:港澳居住证 13:台湾居民居住证 |
| ├─ idcardPrefix | string | 非必须 | 身份证开头 |
| ├─ invoiceType | string | 非必须 | 报销凭证(0 行程单 1 发票 2 行程单+差额发票 3不提供) |
