用户工具

站点工具


4.1_国内实时航班搜索_idomesticticketshopping

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
4.1_国内实时航班搜索_idomesticticketshopping [2024/03/18 03:37]
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 |备注 |  |
行 124: 行 126:
 | <color #ed1c24>change_price_base</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>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:
行 186: 行 189:
 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.1710733075.txt.gz · 最后更改: 2024/03/18 03:37 由 tiny