用户工具

站点工具


4.1_国内实时航班搜索_idomesticticketshopping

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
4.1_国内实时航班搜索_idomesticticketshopping [2021/04/08 02:54]
tiny
4.1_国内实时航班搜索_idomesticticketshopping [2025/03/19 06:01] (当前版本)
doku
行 4: 行 4:
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|origin_destinations   |Array|航段信息列表|Y | | +|origin_destinations   |Array|航段信息列表|Y  | | 
-|airline |Array |航司集合         |N | | +|airline    |Array  |航司集合           |N  | | 
-|physical_cabin |String |舱位等级 |Y |F:头等舱 \\ C:公务舱 \\ Y:经济舱 \\ W:豪华经济舱 | +|physical_cabin |String |舱位等级   |Y  |F:头等舱 \\ C:公务舱 \\ Y:经济舱 \\ W:豪华经济舱 | 
-|is_search_gwbook|bool  |是否需官网价格 |N      |true/false,默认为false| +|is_search_gwbook|bool  |是否需官网价格    |N      |true/false,默认为false| 
-|is_search_rule |bool   |是否查询退改条款|N      | true/false,默认为true;建议不要在shopping时同步查询退改条款,否则容易因为数据量大导致查询异常,可以异步调用/IDomesticShoppingRuleQueryV2接口查询| +|is_search_rule |bool   |是否查询退改条款|N      | true/false,默认为true;\\ 建议不要在shopping时同步查询 \\ 退改条款,否则容易因为数据量 \\ 大导致查询异常,可以异步调 \\ 用/IDomesticShoppingRuleQueryV2 \\ 接口查询| 
-|apply_result |bool |是否含需申请价格|N |true/false,默认为true | +|apply_result   |bool   |是否含需申请价格|N |true/false,默认为true | 
-|passengers     |Array |乘客清单       |Y | | +|passengers     |Array  |乘客清单       |Y  | | 
-|is_get_added_value|bool|是否含增值产品  |N |true/false,默认为false 单程时有效; |+|is_get_added_value|bool|是否含增值产品  |N    |true/false,默认为false 单程时有效; |
  
  
 origin_destinations: origin_destinations:
  
-^参数            ^类型    ^说明         ^必填 ^备注^ +^参数            ^类型    ^说明           ^必填 ^备注^ 
-|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 |  
-|latest_time       |String |最晚出发时间          |Y | HH:mm |+|latest_time       |String |最晚出发时间           |Y | HH:mm |
  
 passengers: passengers:
  
-^参数            ^类型    ^说明         ^必填 ^备注^ +^参数            ^类型    ^说明           ^必填 ^备注^ 
-|passenger_type    |String |乘客类型          |Y | ADT/CHD/INF | +|passenger_type    |String |乘客类型             |Y | 可选值:ADT  CHD  INF | 
-|passenger_count   |Int    |数量          |Y |  |+|passenger_count   |Int    |数量           |Y |  |
  
 ==== 4.1.2请求样例 ==== ==== 4.1.2请求样例 ====
行 38: 行 38:
   "origin_destinations": [   "origin_destinations": [
     {     {
- "departure_city": "CAN", +            "departure_city": "CAN", 
- "arrival_city": "JGS", +            "arrival_city": "JGS", 
- "departure_date": "2018-08-01", +            "departure_date": "2018-08-01", 
- "earlies_time": "00:00", +            "earlies_time": "00:00", 
- "latest_time": "23:00"+            "latest_time": "23:00"
     }     }
   ],   ],
行 66: 行 66:
 ==== 4.1.3返回参数 ==== ==== 4.1.3返回参数 ====
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|code |String |是否调用接口成功 |20000表示成功,非20000表异常 | +|code   |String |是否调用接口成功   |20000表示成功,非20000表异常 | 
-|detail |Object |结果集  |  | +|detail |Object |结果集     |  | 
-|description |String |描述 |当异常时记录异常信息 |+|description |String    |描述 |当异常时记录异常信息 |
  
 detail: detail:
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|serialNumber |String |缓存key |下单时回传给接口 | +|serialNumber   |String |缓存key  |下单时回传给接口 | 
-|flightList |Array |行程组 | |+|flightList |Array  |行程组    
 +|payCurrency |String  |币种  |  <color #ed1c24>20250318 新增预留字段,暂未启用</color>  |
  
  
 flightList: flightList:
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|flight_id |String |行程ID 唯一标示,下单时将选择的航班信息ID回传给接口 | | +|flight_id  |String |行程ID   唯一标示,下单时将选择的航班信息ID回传给接口 | | 
-|cabin_fares |Array  |舱位信息列表 | | +|cabin_fares    |Array  |舱位信息列表 | | 
-|trips   |Array |行程信息列表 | |  +|trips      |Array  |行程信息列表 | |  
- +            
  
 cabin_fares: cabin_fares:
  
-^参数             ^类型     ^说明 ^备注^ +^ 参数                  ^ 类型      ^ 说明        ^ 备注                                                                        
-|psg_fares     |Array     |旅客票价信息列表      |  | +| psg_fares           | Array   | 旅客票价信息列表  |                                                                           
-|cabin_name     |String     |舱等        |  +cabin               |String     |舱等代码        |F:头等舱 \\ C:公务舱 \\ Y:经济舱 \\ W:豪华经济舱 | 
-|cabin_fare_id      |String         |舱位id  |  +| cabin_name          |String     |舱等名称            
-|class_code         |String     |舱位    |  +| cabin_fare_id       | String  | 舱位id                                                                                
-|sub_class_code     |String     |子舱位       +| class_code          | String  | 舱位                                                                                  
-|seat             |String     |座位数        |A则座位数> <9则为具体数量  +| sub_class_code      | String  | 子舱位                                                                                 
-|rule_obj           |Object     |条款        |  +| seat                | String  | 座位数       | A则座位数> <9则为具体数量                                                         
-|cabin_fare_Number  |String     |价格序号        |  +| rule_obj            | Object  | 条款        |                                                                           
-|valueAddedProducts |String     |增值产品        |该舱位可能存在的其它增值产品运价说明(多个,号隔开),此处列出该舱位可能存在的其它增值产品;并非指运价已包括这些增值产品;需再从询价接口获取价格 | +| cabin_fare_Number   | String  | 价格序号                                                                                
-|tripsOrder  |String     |行程单        |无行程单:空值或=“30”  |+| valueAddedProducts  | String  | 增值产品      | 该舱位可能存在的其它增值产品运价说明(多个,号隔开),此处列出该舱位可能存在的其它增值产品;并非指运价已包括这些增值产品;需再从询价接口获取价格 
 +| tripsOrder          | String  | 行程单       | 无行程单:空值或=“30” 普通:10 中性:20                                                 |
  
 rule_obj: rule_obj:
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|rules |Array |退改条款 |  |+|rules  |Array |退改条款 |  |
  
 rules: rules:
  
-^参数            ^类型 ^说明 ^备注^+^参数            ^类型  ^说明 ^备注^
 |change_conditions|String |是否可签转 |  | |change_conditions|String |是否可签转 |  |
 |rule_remark|String |备注 |  | |rule_remark|String |备注 |  |
行 114: 行 116:
  
 rule_item: rule_item:
-^参数 ^类型 ^说明 ^备注^ +^ 参数                                        ^ 类型       ^ 说明            ^ 备注                                                                       
-|operator_hour_text|String |适用条件|  +| operator_hour_text                        | String   | 适用条件                                                                                   
-|change_price|decimal |同舱改签费 | +| change_price                              | decimal  | 同舱改签费         |                                                                          
-|refund_price|decimal |退票费用 |  +| refund_price                              | decimal  | 退票费用                                                                                   
-|hour|String |(起飞前OR起飞后)小时 | | +| hour                                      | String   | (起飞前OR起飞后)小时                                                                           
-|operator_th|String |对hour的标注 | 10:距离起飞前hour \\ 20:距离起飞前(含)hour \\  30:起飞前X小时后hour \\ 40:起飞前X小时后(含)hour|+| operator_th                               | String   | 对hour的标注      | 10:距离起飞前hour \\ 20:距离起飞前(含)hour \\  30:起飞前X小时后hour \\ 40:起飞前X小时后(含)hour  | 
 +| <color #ed1c24>refund_percent</color>     | decimal  | 退票百分比         | 2024/03/18 新增                                                            | 
 +| <color #ed1c24>change_percent</color>     | decimal  | 改签百分比         | 2024/03/18 新增                                                            | 
 +| <color #ed1c24>change_price_base</color>  | decimal  | 改签费保底金额       | 2024/03/18 新增                                                            | 
 +| <color #ed1c24>refund_price_base</color>  | decimal  | 退票保底金额        | 2024/03/18 新增                                                            | 
 +| <color #ed1c24>cabin_code_base</color>    | String   | 计算退改基础舱位      | 2024/03/18 新增                                                            |
  
 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 |行程单|  普通中性、无+| 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_issue_time |String |出票开始工作时间  |  | +|start_issue_time   |String |出票开始工作时间    |  | 
-|end_issue_time|String |出票截止工作时间  |  | +|end_issue_time|String  |出票截止工作时间    |  | 
-|start_void_time |String |废票开始工作时间  |  | +|start_void_time    |String |废票开始工作时间    |  | 
-|end_void_time|String |废票截止工作时间  |  | +|end_void_time|String   |废票截止工作时间    |  | 
-|start_refund_change_time |String |退改开始工作时间  |  |  +|start_refund_change_time   |String |退改开始工作时间    |  |  
-|end_refund_change_time |String |退改截止工作时间  |  |+|end_refund_change_time |String |退改截止工作时间    |  |
  
  
 trips: trips:
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|origin |String |出发地  +|origin |String |出发地     
-|arrival|String |目的地  +|arrival|String |目的地     
-|flights |Array |航班信息集合 |+|flights    |Array  |航班信息集合  |
  
 flights: flights:
  
-^参数 ^类型 ^说明 ^备注^ +^ 参数                 ^ 类型      ^ 说明      ^ 备注  
-|departure_airport|String |出发机场 |  +| departure_airport  | String  | 出发机场        
-|departure_date|String |出发日期  | | +| departure_date     | String  | 出发日期        
-|departure_time |String |出发时间  | | +| departure_time     | String  | 出发时间        
-|arrival_airport |String |到达机场 | +| arrival_airport    | String  | 到达机场        
-|arrival_date |String |到达日期 | | +| arrival_date       | String  | 到达日期        
-|arrival_time |String |到达时间 |  +| arrival_time       | String  | 到达时间        
-|airline|String |航司 | | +| airline            | String  | 航司          
-|flight_number|String |航班号 | | +| flight_number      | String  | 航班号         
-|code_share|Object |共享航班信息 | | +| code_share         | Object  | 共享航班信息      
-|equipment|String |机型|  +| equipment          | String  | 机型          
-|dep_term|String |出发航站楼 | | +| dep_term           | String  | 出发航站楼       
-|arr_term|String |到达航站楼 | | +| arr_term           | String  | 到达航站楼       
-|meal|String |餐食|  +| meal               | String  | 餐食          
-|week|String |星期 | | +| week               | String  | 星期          
-|stop|String |经停 | | +| stop               | String  | 经停          
-|stopInfos|Array |经停信息 |  +| stopInfos          | Array   | 经停信息        | 
 +| mileages           | Int?    | 里程      |     | 
  
 code_share: code_share:
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|carrier |String |航司 |  +|carrier    |String |航司 |    
-|flight_number |String |航班号 |  |+|flight_number  |String |航班号 |   |
  
 stopInfo: stopInfo:
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|stop_city |String |经停机场 | | +|stop_city  |String |经停机场 |  | 
-|stop_time |String |经停时间  | | +|stop_time  |String |经停时间    | | 
  
  
4.1_国内实时航班搜索_idomesticticketshopping.1617850468.txt.gz · 最后更改: 2021/04/08 02:54 由 tiny