美亚航旅机票B2B接口

用户工具

站点工具

4.1_国内实时航班搜索_idomesticticketshopping_inside

这是本文档旧的修订版！

目录

4.1 国内实时航班搜索(IDomesticTicketShopping)

4.1.1请求参数

参数 类型 说明 必填 备注
origin_destinations Array航段信息列表Y
airline Array 航司集合 N
physical_cabin String 舱位等级 Y F:头等舱
C:公务舱
Y:经济舱
W:豪华经济舱
is_search_gwbookbool 是否需官网价格 N true/false，默认为false
is_search_rule bool 是否查询退改条款N true/false，默认为true；
建议不要在shopping时同步查询退改条款，否则容易因为数据量大导致查询异常，
可以异步调用/IDomesticShoppingRuleQueryV2接口查询
apply_result bool 是否含需申请价格N true/false，默认为true
passengers Array 乘客清单 Y
is_get_added_valuebool是否含增值产品 N true/false，默认为false 单程时有效;
targets Array 数据源 N 按API配置的数据源传递 芯斗云使用
specific_carrier_info Object 航司特殊信息 N

origin_destinations：

参数 类型 说明 必填 备注
departure_city String 出发地 Y 上海市:SHA2; 虹桥机场:SHA; 浦东机场:PVG
arrival_city String 目的地 Y 上海市:SHA2; 虹桥机场:SHA; 浦东机场:PVG
departure_date String 出发日期 Y YYYY-MM-DD
earlies_time String 最早出发时间 Y HH:mm
latest_time String 最晚出发时间 Y HH:mm

passengers:

参数 类型 说明 必填 备注
passenger_type String 乘客类型 Y ADT/CHD/INF
passenger_count Int 数量 Y

specific_carrier_info:

参数 类型 说明 必填 备注
account_codes Array 大客户信息 N
account_code_type String 大客户价格显示方式 N 1：返回大客户和普通运价中最低
2：分别返回大客户和普通运价最低
3：只返回大客户运价中最低

account_codes:

参数 类型 说明 必填 备注
office String office号 N
carrier String 航司 N
code String 大客户编号N

4.1.2请求样例

{
  "origin_destinations": [
    {
        "departure_city": "CAN",
        "arrival_city": "JGS",
        "departure_date": "2018-08-01",
        "earlies_time": "00:00",
        "latest_time": "23:00"
    }
  ],
  "airline": [
    "CZ"
  ],
  "physical_cabin": "",
  "apply_result": false,
  "is_search_gwbook": true,
  "passengers":[
     { 
        "passenger_type":"ADT",
        "passenger_count":1
     }
   ]

}

4.1.3返回参数

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

detail:

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

flightList：

参数 类型 说明 备注
flight_id String 行程ID 唯一标示，下单时将选择的航班信息ID回传给接口
cabin_fares Array 舱位信息列表
trips Array 行程信息列表

cabin_fares：

参数 类型 说明 备注
psg_fares Array 旅客票价信息列表
cabin_name String 舱等
cabin_fare_id String 舱位id
class_code String 舱位
sub_class_code String 子舱位
seat String 座位数 A则座位数>9 <9则为具体数量
rule_obj Object 条款
cabin_fare_Number String 价格序号
valueAddedProducts String 增值产品 该舱位可能存在的其它增值产品运价说明(多个,号隔开)，此处列出该舱位可能存在的其它增值产品;
并非指运价已包括这些增值产品;需再从询价接口获取价格
tripsOrder String 行程单 无行程单：空值或=“30”
account_fare_tag String 协议价标识 0为非协议价 1为协议价
account_codeString 大客户编码
fare_basisString 运价基础
y_fare decimal Y舱全价

rule_obj：

参数 类型 说明 备注
rules Array 退改条款

rules：

参数 类型 说明 备注
change_conditionsString 是否可签转
rule_remarkString 备注
rules_itemArray退改明细
baggage_allowanceString行李额
baggage_remarkString行李额说明

rule_item:

参数 类型 说明 备注
operator_hour_text String 适用条件
change_price decimal 同舱改签费
refund_price decimal 退票费用
hour String (起飞前OR起飞后)小时
operator_th String 对hour的标注 10:距离起飞前hour
20:距离起飞前（含）hour
30:起飞前X小时后hour
40:起飞前X小时后（含）hour
refund_percent decimal 退票百分比
change_percent decimal 改签百分比
change_price_base decimal 改签费保底金额
refund_price_base decimal 退票保底金额

psg_fares：

参数 类型 说明 备注
passenger_type String 乘客类型 ADT:成人 CHD:儿童 INF:婴儿
discount decimal折扣 折扣
base_fare decimal票面价
airport_tax decimal机场建设费
oil_tax decimal燃油费
l_reward_fare decimal奖励费用
m_commission decimal 代理费
m_fare String 奖励
service_fare decimal 服务费
total_fare decimal 总价
fare_type int 运价类型1：普通
2：航司官网
3：特殊
4：特价
is_need_apply bool 是否需申请 True：是;需人工跟进 false：否
trips_order String 行程单 普通、中性、无
trips_order_remarkString 行程单说明
meal String 餐食 一般是按航班flights，若特殊舱位有不同，则该字段会有对应说明
serviceinfoObject 工作时间说明
baggage String 行李额

service_time：

参数 类型 说明 备注
start_issue_time String 出票开始工作时间
end_issue_timeString 出票截止工作时间
start_void_time String 废票开始工作时间
end_void_timeString 废票截止工作时间
start_refund_change_time String 退改开始工作时间
end_refund_change_time String 退改截止工作时间

trips:

参数 类型 说明 备注
origin String 出发地
arrivalString 目的地
flights Array 航班信息集合

flights：

参数 类型 说明 备注
departure_airportString 出发机场
departure_dateString 出发日期
departure_time String 出发时间
arrival_airport String 到达机场
arrival_date String 到达日期
arrival_time String 到达时间
airlineString 航司
flight_numberString 航班号
code_shareObject 共享航班信息
equipmentString 机型
dep_termString 出发航站楼
arr_termString 到达航站楼
mealString 餐食
weekString 星期
stopString 经停
stopInfosArray 经停信息
mileagesInt 里程

code_share：

参数 类型 说明 备注
carrier String 航司
flight_number String 航班号

stopInfo：

参数 类型 说明 备注
stop_city String 经停机场
stop_time String 经停时间

4.1.4返回样例

{
    "code": "20000",
    "detail": {
        "flightList": [
            {
                "flight_id": 3,
                "cabin_fares": [
                    {
                        "psg_fares": [
                            {
                                "passenger_type": "ADT",
                                "discount": 6.5,
                                "base_fare": 1160,
                                "airport_tax": 50,
                                "oil_tax": 0,
                                "total_fare": "1712",
                                "l_reward_fare": 78,
                                "service_fare": 10,
                                "fare_type": 3,
                                "trips_order": "10",
                                "trips_order_remark": "20元",
                                "is_need_apply": false,
                                "meal": "10",
                                "serviceinfo": {
                                    "service_time": {
                                        "end_issue_time": "10:09:59",
                                        "end_void_time": "23:59:00",
                                        "start_issue_time": "00:00:00",
                                        "start_void_time": "00:00:00",
                                        "end_refund_change_time": "23:59:59",
                                        "start_refund_change_time": "11:00:00"
                                    }
                                }
                            }
                        ],
                        "cabin": "Y",
                        "cabin_fare_id": "01010101_V",
                        "cabin_name": "经济舱",
                        "class_code": "V",
                        "rule_obj": {
                            "rules": [
                                {
                                    "change_conditions": "",
                                    "rule_remark": "",
                                    "rule_item": [],
                                    "baggage_allowance": "",
                                    "baggage_remark": "20kg"
                                }
                            ]
                        },
                        "seat": "A",
                        "sub_class_code": "",
                        "cabin_fare_Number": 0
                    }
                ],
                "trips": [
                    {
                        "origin": "CAN",
                        "arrival": "SHA",
                        "flights": {
                            "airline": "CA",
                            "airline_cnname": "国航",
                            "arr_term": "T2",
                            "arrival_airport": "SHA",
                            "arrival_airport_cnname": "上海虹桥国际机场",
                            "arrival_airport_short_cnname": "上海虹桥国际机场",
                            "arrival_city": "SHA",
                            "arrival_city_cnname": "上海",
                            "arrival_date": "2020-08-31",
                            "arrival_time": "11:20",
                            "code_share": {
                                "carrier": "",
                                "carrier_cnname": null,
                                "flight_number": ""
                            },
                            "dep_term": "T1",
                            "departure_airport": "CAN",
                            "departure_airport_cnname": "广州白云国际机场",
                            "departure_airport_short_cnname": "广州白云国际机场",
                            "departure_city": "CAN",
                            "departure_city_cnname": "广州",
                            "departure_date": "2020-08-31",
                            "departure_time": "08:55",
                            "equipment": "747",
                            "flight_id": "01010101",
                            "flight_number": "1838",
                            "meal": "FS|JS|YR",
                            "stop": 0,
                            "week": "MON"
                        }
                    }
                ]
            }
        ],
        "serialNumber": "f8f412f6-6407-3b43-f9cc-23822590861c"
    }
}
4.1_国内实时航班搜索_idomesticticketshopping_inside.1710732832.txt.gz · 最后更改: 2024/03/18 03:33 由 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