alitrip.btrip.supplychain.flight.industry.search (机票行业搜索接口)

【商旅】机票行业搜索

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rq FlightSearchRq 可选 入参
  • od_info_list
  • OdInfoRq []
  • 可选
  • 查询的行程列表
  • └ arr_airport_code
  • String []
  • 可选
  • ["123","123"]
  • 到达机场三字码
  • └ arr_city_code
  • String
  • 可选
  • 123
  • 到达城市三字码
  • └ dep_airport_code
  • String []
  • 可选
  • ["123","123"]
  • 出发机场三字码
  • └ dep_city_code
  • String
  • 可选
  • 123
  • 出发城市三字码
  • └ dep_date
  • Date
  • 可选
  • 2021-05-19 00:00:00
  • 起飞日期
  • └ earliest_dep_time
  • Date
  • 可选
  • 2021-05-19 00:00:00
  • 最早起飞时间
  • └ latest_dep_time
  • Date
  • 可选
  • 2021-05-19 00:00:00
  • 最晚起飞时间
  • passenger_quantity_list
  • PassengerQuantityRq []
  • 可选
  • 乘客类型和数量
  • └ passenger_type
  • String
  • 可选
  • ADT
  • 乘客类型;ADT:"普通成人", CHD:"儿童", STU:"留学生", LABOR:"劳工", MIGRANT:"新移民", MARINER:"海员", OLD:"老人", YOUNG:"青年", INFANT:"婴儿", OTHER:"特殊身份"
  • └ quantity
  • Number
  • 可选
  • 1
  • 人员数量
  • trip_preference
  • TripPreferenceRq
  • 可选
  • 飞机信息搜索
  • └ cabin_list
  • String []
  • 可选
  • ["123","123"]
  • 仓位代码
  • └ corp_id
  • String
  • 可选
  • 123
  • 企业id

响应参数

名称 类型 示例值 描述
result HisvResult module 出参
  • module
  • FlightSearchRs
  • module
  • 机票搜索结果
  • item_list
  • GroupItemRs []
  • []
  • 组合商品列表
  • route_info
  • RouteInfoRs
  • module
  • 行程信息
  • journey_list
  • JourneyRs []
  • []
  • 组成当前线路的形成列表
  • └ arr_city
  • String
  • 123
  • 到达城市
  • └ arr_time
  • Date
  • 2021-05-19 00:00:00
  • 到达时间
  • └ dep_city
  • String
  • 123
  • 出发城市
  • └ dep_time
  • Date
  • 2021-05-19 00:00:00
  • 出发时间
  • └ duration
  • Number
  • 90
  • 总时长
  • segment_list
  • FlightSegmentRs []
  • []
  • 组成当前行程的航段列表
  • └ arr_airport
  • String
  • 123
  • 航班到达机场三字码
  • └ arr_city
  • String
  • 123
  • 到达城市三字码
  • └ arr_country
  • String
  • 123
  • 到达国家
  • └ arr_date_int
  • Number
  • 20210519
  • 到达数字日期(yyyyMMdd)
  • └ arr_term
  • String
  • T2
  • 航班到达航站楼
  • └ arr_time
  • Date
  • 2021-05-19 00:00:00
  • 到达日期时间(yyyy-MM-dd HH:mm:ss)
  • └ dep_airport
  • String
  • 123
  • 航班起飞机场三字码
  • └ dep_city
  • String
  • 123
  • 出发城市三字码
  • └ dep_country
  • String
  • 123
  • 出发国家
  • └ dep_date_int
  • Number
  • 20210519
  • 出发数字日期(yyyyMMdd)
  • └ dep_term
  • String
  • T2
  • 航班出发航站楼
  • └ dep_time
  • Date
  • 2021-05-19 00:00:00
  • 出发日期时间(yyyy-MM-dd HH:mm:ss)
  • └ duration
  • Number
  • 90
  • 时长(单位:分钟)
  • └ equip_type
  • String
  • 737
  • 机型
  • └ id
  • String
  • CZ6724CSXKWE0331
  • 航班号+出发机场+达到机场+起飞时间(精确分)
  • └ marketing_airline
  • String
  • CZ
  • 市场方航司(如:KA)
  • └ marketing_flight_no
  • String
  • CZ6724
  • 市场方航班号(如:KA5809)
  • └ marketing_flight_no_int
  • Number
  • 6724
  • 市场方数字航班号(如:5809)
  • └ meal
  • Number
  • 0
  • 餐食类型,0:无参食;1:有餐食;2:饮品;3:茶点;4:早餐;5:正餐;
  • └ miles
  • Number
  • 0
  • 里程
  • segment_show_info
  • SegmentShowInfoRs
  • module
  • 航段展示信息
  • └ arr_airport_name
  • String
  • 贵阳龙洞堡机场
  • 到达机场名称
  • └ arr_airport_short_name
  • String
  • 贵阳龙洞堡机场
  • 到达机场短名称
  • └ arr_city_name
  • String
  • 贵阳
  • 到达城市名称
  • └ dep_airport_name
  • String
  • 黄花机场
  • 出发机场名称
  • └ dep_airport_short_name
  • String
  • 黄花机场
  • 出发机场短名称
  • └ dep_city_name
  • String
  • 长沙
  • 出发城市名称
  • └ equip_manufacturer
  • String
  • 波音
  • 飞机品牌
  • └ equip_type_name
  • String
  • 中型机
  • 飞机类型
  • └ equip_type_show_text
  • String
  • 737
  • 机型展示文案
  • └ meal_desc
  • String
  • 无餐食
  • 是否含餐
  • └ stop_city_codes
  • String []
  • ["123","123"]
  • 经停城市Code
  • └ stop_city_names
  • String []
  • ["123","123"]
  • 经停城市名称
  • └ seq_id
  • Number
  • 0
  • 航段序号,从0开始
  • └ stop_city
  • String
  • 0
  • 经停城市,多个值使用","分隔
  • └ stop_quantity
  • Number
  • 0
  • 经停次数
  • └ transfer_change_airport
  • Boolean
  • false
  • 是否换机场
  • └ transfer_time
  • Number
  • 0
  • 时间
  • └ seq_id
  • Number
  • 0
  • 航程序号,从0开始
  • └ transfer_change_airport
  • Boolean
  • false
  • 是否换机场
  • └ transfer_time
  • Number
  • 0
  • 总中转时间
  • shopping_items
  • PassengerFlightShoppingItemRs []
  • []
  • 成人、儿童、老人对应的报价信息
  • └ passenger_type
  • String
  • ADT
  • 乘客类型
  • shopping_item
  • FlightShoppingItemRs
  • module
  • 机票报价
  • search_price
  • SearchPriceRs
  • module
  • 搜索提供的报价
  • └ original_sell_price
  • Number
  • 0
  • 原始销售价,活动前的价格(单位:元)
  • └ sell_price
  • Number
  • 0
  • 销售价(单位:元)
  • └ tax
  • Number
  • 0
  • 参考税(单位:元)
  • segment_cabin_prices
  • SegmentCabinPriceRs []
  • []
  • 每一航段对应的仓位、价格
  • cabin
  • CabinRs
  • module
  • 仓位信息
  • └ cabin
  • String
  • E
  • 舱位代码
  • └ cabin_class
  • String
  • Y
  • 舱位等级
  • └ cabin_class_memo
  • String
  • 123
  • 舱位等级描述
  • └ cabin_class_name
  • String
  • 经济舱
  • 舱位等级名称,如果存在自定义则展示自定义名称,否则展示通用名称
  • └ quantity
  • String
  • 1
  • 舱位所剩余座位数量,0~9: 剩余0~9个座位; A: 大于9个座位
  • └ specification
  • String
  • 123
  • 国内特殊说明
  • search_price
  • SearchPriceRs
  • module
  • 搜索提供的价格信息
  • └ original_sell_price
  • Number
  • 0
  • 原始销售价,活动前的价格(单位:元)
  • └ sell_price
  • Number
  • 0
  • 销售价(单位:元)
  • └ tax
  • Number
  • 0
  • 参考税(单位:元)
  • segment
  • SegmentPositionRs
  • module
  • 航段
  • └ journey_index
  • Number
  • 1
  • 航程序号
  • └ segment_index
  • Number
  • 1
  • 航段序号
  • └ result_code
  • Number
  • 0
  • 返回码
  • └ result_msg
  • String
  • 成功
  • 错误信息
  • └ is_success
  • Boolean
  • true
  • 成功标识

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripSupplychainFlightIndustrySearchRequest req = new AlitripBtripSupplychainFlightIndustrySearchRequest();
AlitripBtripSupplychainFlightIndustrySearchRequest.FlightSearchRq obj1 = new AlitripBtripSupplychainFlightIndustrySearchRequest.FlightSearchRq();
List<AlitripBtripSupplychainFlightIndustrySearchRequest.OdInfoRq> list3 = new ArrayList<AlitripBtripSupplychainFlightIndustrySearchRequest.OdInfoRq>();
AlitripBtripSupplychainFlightIndustrySearchRequest.OdInfoRq obj4 = new AlitripBtripSupplychainFlightIndustrySearchRequest.OdInfoRq();
list3.add(obj4);
obj4.setArrAirportCode(""123","123"");
obj4.setArrCityCode("123");
obj4.setDepAirportCode(""123","123"");
obj4.setDepCityCode("123");
obj4.setDepDate(StringUtils.parseDateTime("2021-05-19 00:00:00"));
obj4.setEarliestDepTime(StringUtils.parseDateTime("2021-05-19 00:00:00"));
obj4.setLatestDepTime(StringUtils.parseDateTime("2021-05-19 00:00:00"));
obj1.setOdInfoList(list3);
List<AlitripBtripSupplychainFlightIndustrySearchRequest.PassengerQuantityRq> list6 = new ArrayList<AlitripBtripSupplychainFlightIndustrySearchRequest.PassengerQuantityRq>();
AlitripBtripSupplychainFlightIndustrySearchRequest.PassengerQuantityRq obj7 = new AlitripBtripSupplychainFlightIndustrySearchRequest.PassengerQuantityRq();
list6.add(obj7);
obj7.setPassengerType("ADT");
obj7.setQuantity(1L);
obj1.setPassengerQuantityList(list6);
AlitripBtripSupplychainFlightIndustrySearchRequest.TripPreferenceRq obj8 = new AlitripBtripSupplychainFlightIndustrySearchRequest.TripPreferenceRq();
obj8.setCabinList(""123","123"");
obj1.setTripPreference(obj8);
obj1.setCorpId("123");
req.setRq(obj1);
AlitripBtripSupplychainFlightIndustrySearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_supplychain_flight_industry_search_response>
    <result>
        <module>
            <item_list>
                <group_item_rs>
                    <route_info>
                        <journey_list>
                            <journey_rs>
                                <arr_city>123</arr_city>
                                <arr_time>2021-05-19 00:00:00</arr_time>
                                <dep_city>123</dep_city>
                                <dep_time>2021-05-19 00:00:00</dep_time>
                                <duration>90</duration>
                                <segment_list>
                                    <flight_segment_rs>
                                        <arr_airport>123</arr_airport>
                                        <arr_city>123</arr_city>
                                        <arr_country>123</arr_country>
                                        <arr_date_int>20210519</arr_date_int>
                                        <arr_term>T2</arr_term>
                                        <arr_time>2021-05-19 00:00:00</arr_time>
                                        <dep_airport>123</dep_airport>
                                        <dep_city>123</dep_city>
                                        <dep_country>123</dep_country>
                                        <dep_date_int>20210519</dep_date_int>
                                        <dep_term>T2</dep_term>
                                        <dep_time>2021-05-19 00:00:00</dep_time>
                                        <duration>90</duration>
                                        <equip_type>737</equip_type>
                                        <id>CZ6724CSXKWE0331</id>
                                        <marketing_airline>CZ</marketing_airline>
                                        <marketing_flight_no>CZ6724</marketing_flight_no>
                                        <marketing_flight_no_int>6724</marketing_flight_no_int>
                                        <meal>0</meal>
                                        <miles>0</miles>
                                        <segment_show_info>
                                            <arr_airport_name>贵阳龙洞堡机场</arr_airport_name>
                                            <arr_airport_short_name>贵阳龙洞堡机场</arr_airport_short_name>
                                            <arr_city_name>贵阳</arr_city_name>
                                            <dep_airport_name>黄花机场</dep_airport_name>
                                            <dep_airport_short_name>黄花机场</dep_airport_short_name>
                                            <dep_city_name>长沙</dep_city_name>
                                            <equip_manufacturer>波音</equip_manufacturer>
                                            <equip_type_name>中型机</equip_type_name>
                                            <equip_type_show_text>737</equip_type_show_text>
                                            <meal_desc>无餐食</meal_desc>
                                            <stop_city_codes>
                                                <string>[&quot;123&quot;</string>
                                                <string>&quot;123&quot;]</string>
                                            </stop_city_codes>
                                            <stop_city_names>
                                                <string>[&quot;123&quot;</string>
                                                <string>&quot;123&quot;]</string>
                                            </stop_city_names>
                                        </segment_show_info>
                                        <seq_id>0</seq_id>
                                        <stop_city>0</stop_city>
                                        <stop_quantity>0</stop_quantity>
                                        <transfer_change_airport>false</transfer_change_airport>
                                        <transfer_time>0</transfer_time>
                                    </flight_segment_rs>
                                </segment_list>
                                <seq_id>0</seq_id>
                                <transfer_change_airport>false</transfer_change_airport>
                                <transfer_time>0</transfer_time>
                            </journey_rs>
                        </journey_list>
                    </route_info>
                    <shopping_items>
                        <passenger_flight_shopping_item_rs>
                            <passenger_type>ADT</passenger_type>
                            <shopping_item>
                                <search_price>
                                    <original_sell_price>0</original_sell_price>
                                    <sell_price>0</sell_price>
                                    <tax>0</tax>
                                </search_price>
                                <segment_cabin_prices>
                                    <segment_cabin_price_rs>
                                        <cabin>
                                            <cabin>E</cabin>
                                            <cabin_class>Y</cabin_class>
                                            <cabin_class_memo>123</cabin_class_memo>
                                            <cabin_class_name>经济舱</cabin_class_name>
                                            <quantity>1</quantity>
                                            <specification>123</specification>
                                        </cabin>
                                        <search_price>
                                            <original_sell_price>0</original_sell_price>
                                            <sell_price>0</sell_price>
                                            <tax>0</tax>
                                        </search_price>
                                        <segment>
                                            <journey_index>1</journey_index>
                                            <segment_index>1</segment_index>
                                        </segment>
                                    </segment_cabin_price_rs>
                                </segment_cabin_prices>
                            </shopping_item>
                        </passenger_flight_shopping_item_rs>
                    </shopping_items>
                </group_item_rs>
            </item_list>
        </module>
        <result_code>0</result_code>
        <result_msg>成功</result_msg>
        <is_success>true</is_success>
    </result>
</alitrip_btrip_supplychain_flight_industry_search_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部