美亚航旅机票B2B接口

用户工具

站点工具

3.1_实时航班搜索_国际机票_iticketshoppingv2

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版 		前一修订版
3.1_实时航班搜索_国际机票_iticketshoppingv2 [2024/03/05 03:48]
tiny 		3.1_实时航班搜索_国际机票_iticketshoppingv2 [2025/03/19 05:50] (当前版本)
doku
行 5: 行 5:
  
 ^ 参数                                 ^ 类型      ^ 说明         ^ 必填  ^ 备注                          ^ ^ 参数                                 ^ 类型      ^ 说明         ^ 必填  ^ 备注                          ^
-| isDirection                        | String  | 飞行偏好       | Y   | 0=不限 \\ 1=直飞 \\ 2=中转        |+| isDirection                        | String  | 飞行偏好       | Y   | 0=不限 \\ 1=直飞 \\ <color #ed1c24>2=最大中转1次</color>  \\ <color #ed1c24>3=最大中转2次</color>      |
 | airline                            | String  | 航司         | N   | 可以传入多个，用逗号隔开                | | airline                            | String  | 航司         | N   | 可以传入多个，用逗号隔开                |
 | cabinType                          | String  | 舱位等级       | Y   | 0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱   | | cabinType                          | String  | 舱位等级       | Y   | 0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱   |
行 13: 行 13:
 | studentNumber                      | Int     | 学生数量       | N   |                             | | studentNumber                      | Int     | 学生数量       | N   |                             |
 | isAsync                            | Int     | 是否异步       | N   |使用3.14异步请求时 传1 返回serialNumber| | isAsync                            | Int     | 是否异步       | N   |使用3.14异步请求时 传1 返回serialNumber|
-| specification                      | String  | 产品规则       | N   |                             |+| specification                      | String  | 产品规则       | N   |  0不限  1可退  2可改  3可退可改  4含行李  |
 | isMix                              | Int     | 是否允许混仓     | N   |                             | | isMix                              | Int     | 是否允许混仓     | N   |                             |
 | isItinerary                        | Int     | 是否包含行程单    | N   |                             | | isItinerary                        | Int     | 是否包含行程单    | N   |                             |
 | odList                             | Array   | 航段信息集合     | Y   |                             | | odList                             | Array   | 航段信息集合     | Y   |                             |
 | <del>stopOverStyle</del>           | Int     | 经停城市机场信息   | N   | <color #ed1c24>已停用</color>  | | <del>stopOverStyle</del>           | Int     | 经停城市机场信息   | N   | <color #ed1c24>已停用</color>  |
-| <color #ed1c24>includeNDC</color>  | String  | 是否包含NDC信息  | N   | 20210813新增 如不指定则默认0，不包含     |+| <color #ed1c24>includeNDC</color>  | String  | 是否包含NDC信息  | N   | 20210813新增 如不指定则默认0，不包含 <color #ed1c24>自2024/07/03日起 此字段已不支持</color>     |
  
  
 odList： odList：
  
-^参数         ^说明         ^必填 ^备注^ +^参数         ^说明         ^必填 ^备注^ 
-|departureCode |出发城市编码 |Y |  | +|departureCode  |出发城市编码 |Y  |  | 
-|destinationCode|到达城市编码 |Y | | +|destinationCode|到达城市编码 |Y  | | 
-|departureDate |出发日期 |Y |格式：yyyy-MM-dd |+|departureDate  |出发日期   |Y  |格式：yyyy-MM-dd |
  
  
行 115: 行 115:
 ==== 3.1.3返回参数 ==== ==== 3.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  |下单时回传给接口 | 
-|flightDetailList |Array |行程组 | | +|flightDetailList   |Array  |行程组    | | 
 +|payCurrency |String  |币种  |  <color #ed1c24>20250318 新增预留字段，暂未启用</color>  |
  
 flightDetailList： flightDetailList：
  
 ^ 参数             ^ 类型      ^ 说明                            ^ 备注  ^ ^ 参数             ^ 类型      ^ 说明                            ^ 备注  ^
-| flightID       | String  | 行程ID 唯一标示，下单时将选择的航班信息ID回传给接口  |     |+| flightID       | String  | 行程ID   唯一标示，下单时将选择的航班信息ID回传给接口  |     |
 | airline        | String  | 航司                            | <color #ed1c24>NDC产品计价时必须使用此字段作为计价接口的airline入参</color> | | airline        | String  | 航司                            | <color #ed1c24>NDC产品计价时必须使用此字段作为计价接口的airline入参</color> |
 | airline_cn     | String  | 航司中文名                         |     | | airline_cn     | String  | 航司中文名                         |     |
行 146: 行 146:
 | refs                             | Array   | 扩展信息                                   |                                    | | refs                             | Array   | 扩展信息                                   |                                    |
 | <color #ed1c24>groupTag</color>  | Bool    | true代表该运价为小团价产品  若退改废必须全部旅客一起申请  | <color #ed1c24>20230921新增</color>  | | <color #ed1c24>groupTag</color>  | Bool    | true代表该运价为小团价产品  若退改废必须全部旅客一起申请  | <color #ed1c24>20230921新增</color>  |
 +| <color #ed1c24>RCVServiceFee </color>                            | Object| 退改废服务费   <color #ed1c24>20241017新增</color>                                  |                       |
  
 financeList： financeList：
  
-^ 参数                 ^ 类型      ^ 说明       ^ 备注           ^ +^ 参数                                        ^ 类型           ^ 说明       ^ 备注                              ^ 
-| passengerType      | String  | 乘客类型     | 0成人 1儿童 2婴儿  | +| passengerType                             | String       | 乘客类型     | 0成人 1儿童 2婴儿                     | 
-| salePrice          | String  | 票面价      |              | +| salePrice                                 | String       | 票面价      |                                 | 
-| tax                | String  | 税金       |              | +| tax                                       | String       | 税金       |                                 | 
-| beforeReturn       | String  | 代理费点数    |              | +| beforeReturn                              | String       | 代理费点数    |                                 | 
-| beforeReturnPrice  | String  | 代理费金额    |              | +| beforeReturnPrice                         | String       | 代理费金额    |                                 | 
-| afterReturnPrice   | String  | 奖励金额     |              | +| afterReturnPrice                          | String       | 奖励金额     |                                 | 
-| serviceFee         | String  | 服务费      |              | +| serviceFee                                | String       | 服务费      |                                 | 
-| saleTotal          | String  | 结算价      |              | +| saleTotal                                 | String       | 结算价      |                                 | 
-| travelItinerary    | String  | 是否有行程单   | 0：无 1：有      | +| travelItinerary                           | String       | 是否有行程单   | 0：无 1：有                         | 
-| beforeReturnMoney  | String  | 代理费直减金额  |              | +| beforeReturnMoney                         | String       | 代理费直减金额  |                                 | 
-| afterReturMoney    | String  | 奖励直减金额   |              | +| afterReturMoney                           | String       | 奖励直减金额   |                                 | 
-| <color #ed1c24>productType</color>    | String  | 产品类型 |   20210813新增 产品类型:BSP、NDC、合作商  | +| <color #ed1c24>productType</color>        | String       | 产品类型     |  20210813新增 产品类型:官网、自营、合作商、NDC  | 
-| sellAdditionRebateRate| String  | 促销返点   |              | +| sellAdditionRebateRate                    | String       | 促销返点     |                                 | 
-| sellAdditionRebateMoneyTotalCNY| String  | 促销直减金额   |              | +| sellAdditionRebateMoneyTotalCNY           | String       | 促销直减金额   |                                 | 
-| sellRebatePointFareCNY| String  | 促销合计金额   |              | +| sellRebatePointFareCNY                    | String       | 促销合计金额   |                                 | 
-| brand | ObjectArray  | 品牌信息   |              |+| brand                                     | ObjectArray  | 品牌信息     |                                 | 
 +| <color #ed1c24>limitingCondition</color>  | Object       | 乘客限制条件   | 202408新增                        | 
 +| <color #ed1c24>farerule</color>           | ObjectArray  | 条款规则     | 202411新增                        | 
 + 
 + 
 +brand 
 +^参数 ^类型 ^说明 ^备注^ 
 +|brandCode |String  |品牌编号    | 
 +|brandName |String  |品牌名称    | 
 +|brandNameCh |String    |品牌名称(中文)    | 
 + 
 +farerule 
 +^ 参数           ^ 类型           ^ 说明      ^ 备注  ^ 
 +| origin       | String       | 出发地三字码  |     | 
 +| destination  | String       | 目的地三字码  |     | 
 +| refund       | ObjectArray  | 退款规则    |     | 
 +| change       | ObjectArray  | 改签规则    |     | 
 +| luggages     | ObjectArray  | 行李规定    |     | 
 + 
 +refund 
 +^参数 ^类型 ^说明 ^备注^ 
 +|typeCode |String  |退票类型,返值[before or after]    | 
 +|statusCode |String  |退票标识 T：不可退 H：有条件退 F：允许 P:允许，可能收取费用    | 
 + 
 +change 
 +^ 参数          ^ 类型      ^ 说明                                  ^ 备注  ^ 
 +| typeCode    | String  | 改签类型,返值[before or after]            |     | 
 +| statusCode  | String  | 改签标识 T：不可改 H：有条件改 F：允许 P:允许，可能收取费用  |     | 
 + 
 + 
 +luggages 
 +^参数 ^类型 ^说明 ^备注^ 
 +|airline |String  |航司    | 
 +|flightNo |String  |航班号    | 
 +|fareBasisCode |String    |fareBasisCode    | 
 +|luggage |ObjectArray  |行李    | 
 + 
 +luggage 
 +^参数 ^类型 ^说明 ^备注^ 
 +|baggageCarryon |Object  |手提行李    | 
 +|baggageChecked |Object  |托运行李    | 
 + 
 +baggageCarryon 
 +^ 参数           ^ 类型      ^ 说明    ^ 备注  ^ 
 +| pieces       | String  | 行李件数  |     | 
 +| weight       | String  | 行李重量  |     | 
 +| demision     | String  | 行李体积  |     | 
 +| description  | String  | 行李描述  |     | 
 + 
 +baggageChecked 
 +^ 参数           ^ 类型      ^ 说明    ^ 备注  ^ 
 +| pieces       | String  | 行李件数  |     | 
 +| weight       | String  | 行李重量  |     | 
 +| demision     | String  | 行李体积  |     | 
 +| description  | String  | 行李描述  |     |
  
-brand  
-^参数 ^类型 ^说明 ^备注^ 
-|brandCode |String |品牌编号 | 
-|brandName |String |品牌名称 | 
-|brandNameCh |String |品牌名称(中文) | 
  
 tripList tripList
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|departureCode |String |出发地  | +|departureCode  |String |出发地     | 
-|destinationCode |String |目的地  | +|destinationCode |String    |目的地     | 
-|flightList |Array |航班信息集合 |+|flightList |Array  |航班信息集合  |
  
 flightList： flightList：
行 225: 行 274:
  
 luggage  luggage 
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|baggageCarryon|OBJECT|手持行李| |  +|baggageCarryon|OBJECT|手持行李| |   
-|baggageChecked|OBJECT|托运行李| | +|baggageChecked|OBJECT|托运行李| |  
  
 baggageCarryon  &&  baggageChecked baggageCarryon  &&  baggageChecked
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|pieces|STRING|行李件数| |  +|pieces|STRING|行李件数| |   
-|weight|STRING|行李重量| |  +|weight|STRING|行李重量| |   
-|demision|STRING|行李体积| | +|demision|STRING|行李体积|  | 
-|description|STRING|描述| | +|description|STRING|描述| |    
 + 
 + 
 +limitingCondition 
 +^参数 ^类型 ^说明 ^备注^ 
 +|nationalityOrArea|Object|国籍/地区限制| |  
 +|certificate|Object|证件限制| | 
 +|availableAge|Object|年龄限制| | 
 +|availablePassagerCount|Object|人数限制| | 
 + 
 + 
 +nationalityOrArea/certificate 
 +^参数 ^类型 ^说明 ^备注^ 
 +|isAllow|Boolean|是否允许|true:则允许codes的国籍/地区(证件类型) false:则禁止codes的国籍/地区(证件类型) |  
 +|codes|Array|国家/地区二字码(证件类型参考下单IDType)|该参数有值时isAllow有效 | 
 +|names|Array|国家/地区(证件类型)中文名称| | 
 + 
 +availableAge 
 +^参数 ^类型 ^说明 ^备注^ 
 +|minAge|Int|最小年龄限制|默认值:-1(无限制)  |  
 +|maxAge|Int|最大年龄限制|默认值:-1(无限制) |  
 + 
 +availablePassagerCount 
 +^参数 ^类型 ^说明 ^备注^ 
 +|minCount|Int|最小人数限制 |默认值:-1(无限制)  |  
 +|maxCount|Int|最大人数限制 |默认值:-1(无限制)  |  |  
 +|beEvenNumber|Boolean|是否偶数人数限制 |  
 + 
 + 
 +RCVServiceFee 
 +^参数 ^类型 ^说明 ^备注^ 
 +|ChangeFeeCNY|Float|改签加收服务费 |无数据则以退票时为准 |  
 +|RefundFeeCNY|Float|退票加收服务费 | 无数据则以退票时为准|  
 +|VoidFeeCNY|Float|废票加收服务费 |无数据则以退票时为准 | 
  
 ==== 3.1.4返回样例 ==== ==== 3.1.4返回样例 ====
行 272: 行 354:
                                     "origin":"WUH",                                     "origin":"WUH",
                                     "destination":"KHH",                                     "destination":"KHH",
- }, +                                }, 
- {+                                {
                                     "fare_basis_code" : "OOWPROMO",                                     "fare_basis_code" : "OOWPROMO",
                                     "free_baggage_allowance" : "30K",                                     "free_baggage_allowance" : "30K",
                                     "origin":"TPE",                                     "origin":"TPE",
                                     "destination":"CAN"                                     "destination":"CAN"
- } +                                } 
- ]+                            ]
  
                         }                         }
3.1_实时航班搜索_国际机票_iticketshoppingv2.1709610526.txt.gz · 最后更改: 2024/03/05 03:48 由 tiny

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki