| 两侧同时换到之前的修订记录
前一修订版
后一修订版
|
前一修订版
|
4.1_国内实时航班搜索_idomesticticketshopping [2024/06/26 01:29]
tiny |
4.1_国内实时航班搜索_idomesticticketshopping [2025/09/11 05:49] (当前版本)
alan_luo |
| |
| ^参数 ^类型 ^说明 ^必填 ^备注^ | ^参数 ^类型 ^说明 ^必填 ^备注^ |
| |departure_city |String |出发地 |Y |上海市:SHA2; 虹桥机场:SHA; 浦东机场:PVG | | |departure_city |String |出发地 |Y |三字码 目前上海城市比较特殊，查询要按以下条件传参：上海市:SHA2；虹桥机场:SHA；浦东机场:PVG | |
| |arrival_city |String |目的地 |Y |上海市:SHA2; 虹桥机场:SHA; 浦东机场:PVG | | |arrival_city |String |目的地 |Y |三字码 目前上海城市比较特殊，查询要按以下条件传参：上海市:SHA2；虹桥机场:SHA；浦东机场:PVG | |
| |departure_date |String |出发日期 |Y | YYYY-MM-DD | | |departure_date |String |出发日期 |Y | YYYY-MM-DD | |
| |earlies_time |String |最早出发时间 |Y | HH:mm | | |earlies_time |String |最早出发时间 |Y | HH:mm | |
| |serialNumber |String |缓存key |下单时回传给接口 | | |serialNumber |String |缓存key |下单时回传给接口 | |
| |flightList |Array |行程组 | | | |flightList |Array |行程组 | | |
| | |payCurrency |String |币种 | <color #ed1c24>20250318 新增预留字段，暂未启用</color> | |
| |
| |
| ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
| | psg_fares | Array | 旅客票价信息列表 | | | | psg_fares | Array | 旅客票价信息列表 | | |
| | cabin |String |舱等代码 |F:头等舱 \\ C:公务舱 \\ Y:经济舱 \\ W:豪华经济舱 | | | cabin | String | 舱等代码 | F:头等舱 \\ C:公务舱 \\ Y:经济舱 \\ W:豪华经济舱 | |
| | cabin_name |String |舱等名称 | | | | cabin_name | String | 舱等名称 | | |
| | cabin_fare_id | String | 舱位id | | | | cabin_fare_id | String | 舱位id | | |
| | class_code | String | 舱位 | | | | class_code | String | 舱位 | | |
| | valueAddedProducts | String | 增值产品 | 该舱位可能存在的其它增值产品运价说明(多个,号隔开)，此处列出该舱位可能存在的其它增值产品;并非指运价已包括这些增值产品;需再从询价接口获取价格 | | | valueAddedProducts | String | 增值产品 | 该舱位可能存在的其它增值产品运价说明(多个,号隔开)，此处列出该舱位可能存在的其它增值产品;并非指运价已包括这些增值产品;需再从询价接口获取价格 | |
| | tripsOrder | String | 行程单 | 无行程单：空值或=“30” 普通:10 中性:20 | | | tripsOrder | String | 行程单 | 无行程单：空值或=“30” 普通:10 中性:20 | |
| | | limitingCondition | Object | 限制条件 | | |
| |
| rule_obj： | rule_obj： |
| rules： | rules： |
| |
| ^参数 ^类型 ^说明 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
| |change_conditions|String |是否可签转 | | | | change_conditions | String | 是否可签转 | | |
| |rule_remark|String |备注 | | | | rule_remark | String | 备注 | | |
| |rules_item|Array|退改明细| | | | rules_item | Array | 退改明细 | <color #ed1c24>已停止维护</color> | |
| |baggage_allowance|String|行李额| | | | baggage_allowance | String | 行李额 | 例：免费托运行李：每件20KG，每人1件，每件体积不超过40×60×100CM；免费手提行李：每件12KG，每人1件，每件体积不超过40×60×100CM | |
| |baggage_remark|String|行李额说明| | | | baggage_remark | String | 行李额说明 | | |
| | | ticketLuggageRule | Object | 行李额结构化信息 | <color #ed1c24>20250428 新增</color> | |
| |
| rule_item: | rule_item: |
| | <color #ed1c24>cabin_code_base</color> | String | 计算退改基础舱位 | 2024/03/18 新增 | | | <color #ed1c24>cabin_code_base</color> | String | 计算退改基础舱位 | 2024/03/18 新增 | |
| |
| | ticketLuggageRule: |
| | |
| | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
| | | checkRuleInfo | String | 托运行李额完整信息 | 例：免费托运行李：每件20KG，每人1件，每件体积不超过40×60×100CM | |
| | | freeCheckCount | String | 免费托运行李重量 | 例：20 | |
| | | freeCheckUnit | String | 免费托运行李单位 | 例：KG | |
| | | freeCheckPcCount | String | 免费托运行李数量 | 例：1 | |
| | | freeCheckLuggage | String | 托运行李额 | 例：20KG | |
| | | checkDescription | String | 托运行李额说明 | 例：每件体积不超过40×60×100CM | |
| | | handRuleInfo | String | 手提行李额完整信息 | 例：免费手提行李：每件20KG，每人1件，每件体积不超过40×60×100CM | |
| | | freehandCount | String | 免费手提行李重量 | 例：20 | |
| | | freehandUnit | String | 免费手提行李单位 | 例：KG | |
| | | freehandPcCount | String | 免费手提行李数量 | 例：1 | |
| | | freehandLuggage | String | 手提行李额 | 例：20KG | |
| | | handDescription | String | 手提行李额说明 | 例：每件体积不超过40×60×100CM | |
| | | freeCheckSource | String | 托运行李额是否是航信的（ibeplus），否则不是 | 例：ibeplus | |
| psg_fares： | psg_fares： |
| |
| ^参数 ^类型 ^说明 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
| |passenger_type |String |乘客类型 |ADT:成人 CHD:儿童 INF:婴儿 | | | passenger_type | String | 乘客类型 | ADT:成人 CHD:儿童 INF:婴儿 | |
| |discount |decimal|折扣 |折扣 | | | discount | decimal | 折扣 | 折扣 | |
| |base_fare |decimal|票面价 | | | base_fare | decimal | 票面价 | | |
| |airport_tax |decimal|机场建设费 | | | | airport_tax | decimal | 机场建设费 | | |
| |oil_tax |decimal|燃油费 | | | | oil_tax | decimal | 燃油费 | | |
| |l_reward_fare |decimal|奖励费用 | | | | l_reward_fare | decimal | 奖励费用 | | |
| |m_commission |decimal |代理费 | | | | m_commission | decimal | 代理费 | | |
| |m_fare |String |奖励 | | | | m_fare | String | 奖励 | | |
| |service_fare |decimal |服务费 | | | | service_fare | decimal | 服务费 | | |
| |total_fare |decimal |总价| | | | total_fare | decimal | 总价 | | |
| |fare_type |int |运价类型|1：普通 \\ 2：航司官网 \\ 3：特殊 \\ 4：特价 | | | fare_type | int | 运价类型 | 1：普通 \\ 2：航司官网 \\ 3：特殊 \\ 4：特价 | |
| |is_need_apply |bool |是否需申请| True：是;需人工跟进 false：否 | | | is_need_apply | bool | 是否需申请 | True：是;需人工跟进 false：否 | |
| |trips_order |String |行程单| 无行程单：空值或=“30” 普通:10 中性:20| | | trips_order | String | 行程单 | 无行程单：空值或=“30” 普通:10 中性:20 | |
| |trips_order_remark|String |行程单说明| | | | trips_order_remark | String | 行程单说明 | | |
| |meal |String |餐食| 一般是按航班flights，若特殊舱位有不同，则该字段会有对应说明 | | | meal | String | 餐食 | B 早餐 \\ C 免费酒精饮料 \\ D 正餐 \\ F 供采购的食物 \\ G 供采购的食物和饮料 \\ H 热的膳食 \\ K 轻快早餐 \\ L 午餐 \\ M 膳食 \\ N 没有饭食供应 \\ O 冷的膳食 \\ P 供采购的酒精饮料 \\ R 茶点\\ S 快餐 \\ V 供采购的茶点\\ 10 未知\\ 20 含餐\\ 30 不含餐 | |
| |serviceinfo|Object |工作时间说明| | | | serviceinfo | Object | 工作时间说明 | | |
| |baggage |String |行李额| | | | baggage | String | 行李额 | | |
| |
| service_time： | service_time： |
| |start_refund_change_time |String |退改开始工作时间 | | | |start_refund_change_time |String |退改开始工作时间 | | |
| |end_refund_change_time |String |退改截止工作时间 | | | |end_refund_change_time |String |退改截止工作时间 | | |
| | |
| | |
| | limitingCondition: |
| | |
| | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
| | | idTypeLimit | String |证件限制{"code": "10","name": "不限"},{"code": "20","name": "限制"} | 例：10| |
| | | idTypes | array[string] | 证件信息{"code":"0","name":"护照"},{"code":"2","name":"身份证"},{"code":"3","name":"港澳通行证"},{"code":"4","name":"回乡证"},{"code":"5","name":"户口簿"},{"code":"6","name":"出生证明"},{"code":"7","name":"台湾通行证"},{"code":"8","name":"台胞证"},{"code":"9","name":"军人证"},{"code":"10","name":"港澳台居民居住证"},{"code":"11","name":"外国人永久居留身份证"},{"code":"12","name":"其他有效证件"},{"code":"13","name":"电子护照"},{"code":"14","name":"海员证"},{"code":"15","name":"外交部签发的驻华外交人员证"}code为值为证件类型，name为证件名称 | 例：10 | |
| | | ageLimit | String | 年龄限制 {"code": "10","name": "不限"},{"code": "20","name": "限制"},{"code": "30","name": "按男女限制"} code为值为证件类型，name为限制类型 | 例：10 | |
| | | maleBegin | int | 男性年龄限制-最小年龄 | 例：20 | |
| | | maleEnd | int | 托运男性年龄限制-最大年龄额 | 例：20 | |
| | | femaleBegin | int | 女性年龄限制-最小年龄 | 例：20| |
| | | femaleEnd | int | 女性年龄限制-最大年龄 | 例：20 | |
| |
| |
