美亚航旅机票B2B接口

用户工具

站点工具

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

目录

3.1实时航班搜索(ITicketShoppingV2)

3.1.1请求参数

参数 类型 说明 必填 备注
isDirection String 飞行偏好 Y 0=不限
1=直飞
2=最大中转1次
3=最大中转2次
airline String 航司 N 可以传入多个，用逗号隔开
cabinType String 舱位等级 Y 0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱
adultNumber Int 成人数量 Y
childNumber Int 儿童数量 N
infantNumber Int 婴儿数量 N
studentNumber Int 学生数量 N
isAsync Int 是否异步 N 使用3.14异步请求时 传1 返回serialNumber
specification String 产品规则 N 0不限 1可退 2可改 3可退可改 4含行李
isMix Int 是否允许混仓 N
isItinerary Int 是否包含行程单 N
odList Array 航段信息集合 Y
stopOverStyle Int 经停城市机场信息 N 已停用
includeNDC String 是否包含NDC信息 N 20210813新增 如不指定则默认0，不包含 自2024/07/03日起 此字段已不支持

odList：

参数 说明 必填 备注
departureCode 出发城市编码 Y
destinationCode到达城市编码 Y
departureDate 出发日期 Y 格式：yyyy-MM-dd

3.1.2请求样例

单程

{
    "isDirection":"0",
    "airline":"",
    "cabinType":"0",
    "odList":[
        {
            "departureCode":"CAN",
            "destinationCode":"SIN",
            "departureDate":"2016-10-01"
        }
    ],
    "adultNumber":1,
    "childNumber":0,
    "infantNumber":0
}

往返

{
    "isDirection":"0",
    "airline":"",
    "cabinType":"0",
    "odList":[
        {
            "departureCode":"CAN",
            "destinationCode":"SIN",
            "departureDate":"2016-10-01"
        },
        {
            "departureCode":"SIN",
            "destinationCode":"CAN",
            "departureDate":"2016-11-01"
        }
    ],
    "adultNumber":1,
    "childNumber":0,
    "infantNumber":0
}

多程

{
    "isDirection":"0",
    "airline":"",
    "cabinType":"0",
    "odList":[
        {
            "departureCode":"CAN",
            "destinationCode":"SIN",
            "departureDate":"2016-10-01"
        },
        {
            "departureCode":"HKG",
            "destinationCode":"BKK",
            "departureDate":"2016-10-20"
        },
        {
            "departureCode":"BKK",
            "destinationCode":"CAN",
            "departureDate":"2016-11-01"
        }
    ],
    "adultNumber":1,
    "childNumber":1,
    "infantNumber":1
}

3.1.3返回参数

参数 类型 说明 备注
code String 是否调用接口成功 20000表示成功，非20000表异常
detail Object 结果集
description String 描述 当异常时记录异常信息

detail:

参数 类型 说明 备注
serialNumber String 缓存key 下单时回传给接口
flightDetailList Array 行程组

flightDetailList：

参数 类型 说明 备注
flightID String 行程ID 唯一标示，下单时将选择的航班信息ID回传给接口
airline String 航司 NDC产品计价时必须使用此字段作为计价接口的airline入参
airline_cn String 航司中文名
financeDetail Object 价格详情
tripList Array 行程信息集合

financeDetail：

参数 类型 说明 备注
officeNumber String 出票OFFICE
airline String 出票航司
agencyPolicyRemark String 代理费政策限制
rewardPolicyRemark String 奖励政策限制
financeList Array 价格组 每种乘客类型一条数据
refs Array 扩展信息
groupTag Bool true代表该运价为小团价产品 若退改废必须全部旅客一起申请 20230921新增

financeList：

参数 类型 说明 备注
passengerType String 乘客类型 0成人 1儿童 2婴儿
salePrice String 票面价
tax String 税金
beforeReturn String 代理费点数
beforeReturnPrice String 代理费金额
afterReturnPrice String 奖励金额
serviceFee String 服务费
saleTotal String 结算价
travelItinerary String 是否有行程单 0：无 1：有
beforeReturnMoney String 代理费直减金额
afterReturMoney String 奖励直减金额
productType String 产品类型 20210813新增 产品类型:官网、自营、合作商、NDC
sellAdditionRebateRate String 促销返点
sellAdditionRebateMoneyTotalCNY String 促销直减金额
sellRebatePointFareCNY String 促销合计金额
brand ObjectArray 品牌信息
limitingCondition Object 乘客限制条件 202408新增

brand

参数 类型 说明 备注
brandCode String 品牌编号
brandName String 品牌名称
brandNameCh String 品牌名称(中文)

tripList

参数 类型 说明 备注
departureCode String 出发地
destinationCode String 目的地
flightList Array 航班信息集合

flightList：

参数 类型 说明 备注
airline String 航司编码
airlineName String 航司名
flightNo String 航班号
classNo String 舱位
departureCityName String 出发城市
destinationCityName String 到达城市
departureCityCode String 出发城市编码
destinationCityCode String 到达城市编码
departureAirportCode String 出发机场编码
destinationAirportCode String 到达机场编码
departureAirportName String 出发机场名
destinationAirportName String 到达机场名
departureDateTime String 出发日期时间
arrivalDateTime String 到达日期时间
seatNumber String 剩余座位数 A:>9 9:>=9 1-8:对应具体数量
equipment String 机型
departureTerm String 出发机场航站楼
destinationTerm String 到达机场航站楼
duration String 飞行时长 HH:mm
codeShare String 共享航班
stopOver Array 经停机场码
cabinType String 舱位等级 0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱

refs

参数 类型 说明 备注
fare_basis_code String 运价基础 默认第一位乘客类型fb
free_baggage_allowance String 行李信息
origin String 出发机场
destination String 到达机场
luggage ObjectArray 行李额相关信息

luggage

参数 类型 说明 备注
passengerType INT 乘客类型 0:成人 1：儿童 2：婴儿
luggage ObjectArray 行李额信息明细
fareBasisCode String 运价基础 当前乘客类型的fb

luggage

参数 类型 说明 备注
baggageCarryonOBJECT手持行李
baggageCheckedOBJECT托运行李

baggageCarryon && baggageChecked

参数 类型 说明 备注
piecesSTRING行李件数
weightSTRING行李重量
demisionSTRING行李体积
descriptionSTRING描述

limitingCondition

参数 类型 说明 备注
nationalityOrAreaObject国籍/地区限制
certificateObject证件限制
availableAgeObject年龄限制
availablePassagerCountObject人数限制

nationalityOrArea/certificate

参数 类型 说明 备注
isAllowBoolean是否允许true:则允许codes的国籍/地区(证件类型) false:则禁止codes的国籍/地区(证件类型)
codesArray国家/地区二字码(证件类型参考下单IDType)该参数有值时isAllow有效
namesArray国家/地区(证件类型)中文名称

availableAge

参数 类型 说明 备注
minAgeInt最小年龄限制默认值:-1(无限制)
maxAgeInt最大年龄限制默认值:-1(无限制)

availablePassagerCount

参数 类型 说明 备注
minCountInt最小人数限制 默认值:-1(无限制)
maxCountInt最大人数限制 默认值:-1(无限制)
beEvenNumberBoolean是否偶数人数限制

3.1.4返回样例

{
    "code":"20000",
    "detail":{
        "serialNumber":"c36d6c9f1e054618a61edba5510e52d5",
        "flightDetailList":[
            {
                "flightID":"b8ac217c60398342",
                "airline":"CZ",
                "airline_cn":"南方航空",
                "financeDetail":{
                    "officeNumber":"SIA227",
                    "airline":"CZ",
                    "agencyPolicyRemark":"",
                    "rewardPolicyRemark":",",
                    "financeList":[
                        {
                            "passengerType":"0",
                            "salePrice":"2990",
                            "tax":"683",
                            "beforeReturn":"0",
                            "afterReturn":"0.5",
                            "beforeReturnPrice":"0",
                            "afterReturnPrice":"15",
                            "serviceFee":"0",
                            "saleTotal":"3658",
                            "fare_type":"Published",
                            "refs" : 
                            [
                                {
                                    "fare_basis_code" : "MOWCN",
                                    "free_baggage_allowance" : "30K",
                                    "origin":"WUH",
                                    "destination":"KHH",
                                },
                                {
                                    "fare_basis_code" : "OOWPROMO",
                                    "free_baggage_allowance" : "30K",
                                    "origin":"TPE",
                                    "destination":"CAN"
                                }
                            ]

                        }
                    ]
                },
                "tripList":[
                    {
                        "departureCode":"WUH",
                        "destinationCode":"KHH",
                        "flightList":[
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"3093",
                                "classNo":"K",
                                "cabinType": "0",
                                "departureCityName":"武汉",
                                "destinationCityName":"高雄",
                                "departureCityCode":"WUH",
                                "destinationCityCode":"KHH",
                                "departureAirportCode":"WUH",
                                "destinationAirportCode":"KHH",
                                "departureAirportName":"武汉天河国际机场",
                                "destinationAirportName":"高雄国际机场",
                                "departureDateTime":"2019-01-31 14:30",
                                "arrivalDateTime":"2019-01-31 17:15",
                                "seatNumber":"A",
                                "duration":"02:45",
                                "equipment":"737",
                                "departureTerm":"T3",
                                "destinationTerm":"",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            }
                        ]
                    },
                    {
                        "departureCode":"TPE",
                        "destinationCode":"WUH",
                        "flightList":[
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"3098",
                                "classNo":"Q",
                                "departureCityName":"台北",
                                "destinationCityName":"广州",
                                "departureCityCode":"TPE",
                                "destinationCityCode":"CAN",
                                "departureAirportCode":"TPE",
                                "destinationAirportCode":"CAN",
                                "departureAirportName":"台湾桃园国际机场",
                                "destinationAirportName":"广州白云国际机场",
                                "departureDateTime":"2019-02-07 14:35",
                                "arrivalDateTime":"2019-02-07 17:00",
                                "seatNumber":"4",
                                "duration":"02:25",
                                "equipment":"330",
                                "departureTerm":"2",
                                "destinationTerm":"T2",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            },
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"6589",
                                "classNo":"Q",
                                "departureCityName":"广州",
                                "destinationCityName":"武汉",
                                "departureCityCode":"CAN",
                                "destinationCityCode":"WUH",
                                "departureAirportCode":"CAN",
                                "destinationAirportCode":"WUH",
                                "departureAirportName":"广州白云国际机场",
                                "destinationAirportName":"武汉天河国际机场",
                                "departureDateTime":"2019-02-07 19:25",
                                "arrivalDateTime":"2019-02-07 21:25",
                                "seatNumber":"A",
                                "duration":"02:00",
                                "equipment":"737",
                                "departureTerm":"T2",
                                "destinationTerm":"T3",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
3.1_实时航班搜索_国际机票_iticketshoppingv2.txt · 最后更改: 2024/08/08 06:57 由 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