文档中心 > API类目 > 国际机票运价采购

alitrip.ie.ticket.service.search (产品询价)

国际机票巴拿马询价接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
search_rq SearchRq 必须 入参
  • └ cabin_type
  • Number
  • 可选
  • 0
  • 舱位等级:0:所有舱位;1:头等舱和商务舱
  • od_info
  • OdInfo []
  • 必须
  • od信息
  • └ arr_city_code
  • String
  • 必须
  • HKG
  • 到达城市三字码
  • └ dep_city_code
  • String
  • 必须
  • BJS
  • 出发城市三字码
  • └ dep_date
  • String
  • 必须
  • 2017-05-26
  • 出发日期
  • selected_flights
  • SelectedFlight []
  • 可选
  • 选择航班
  • └ arr_airport
  • String
  • 必须
  • HKG
  • 到达机场
  • └ dep_airport
  • String
  • 必须
  • PEK
  • 出发机场
  • └ flight_time
  • String
  • 必须
  • 2017-05-26 20:00:00
  • 起飞时间
  • └ market_flight_no
  • String
  • 必须
  • HX313
  • 市场方航班号
  • └ operat_flight_no
  • String
  • 可选
  • HX313
  • 承运方航班号
  • └ cabin_code
  • String
  • 可选
  • J
  • 舱位
  • └ passenger_num
  • Number
  • 必须
  • 3
  • 乘客人数(大于0,小于10)
  • └ trace_id
  • String
  • 必须
  • datgaegeewe
  • traceId
  • └ trip_type
  • Number
  • 必须
  • 1
  • 行程类型:1:单程;2:往返;3:多程
  • └ need_result_num
  • Number
  • 可选
  • 200
  • 默认值:200
  • shopping最多返回结果数,默认200(询价不适用)
  • └ product_selection_code
  • Number
  • 可选
  • 4
  • 废弃。请使用product_select_codes
  • └ search_type
  • Number
  • 可选
  • 0
  • 默认值:0
  • 搜索类型, 0:询价;1:shopping
  • └ only_shop_names
  • String []
  • 可选
  • 飞猪旅行机票自营
  • 仅搜索的店铺名称(飞猪上显示的店铺名称),支持多个
  • └ ignored_shop_names
  • String []
  • 可选
  • 飞猪旅行机票自营
  • 屏蔽的店铺名称(飞猪上显示的店铺名称),支持多个
  • └ product_select_codes
  • Number []
  • 可选
  • [8, 16]
  • 产品类型选择,默认最低价. 1:自营;2:金牌;4:最低价;8:旗舰店;16:极速;64:延迟出票。(当金牌产品是最低票价时,特卖产品不再出现)
  • └ original_pnr_first
  • Boolean
  • 可选
  • false
  • 优先露出原PNR出票的报价

响应参数

名称 类型 示例值 描述
result SearchRs result
  • └ error_code
  • String
  • 1001
  • 错误码
  • └ error_msg
  • String
  • 系统错误
  • 错误信息
  • products
  • Product []
  • 产品信息
  • └ adult_price
  • Number
  • 150000
  • 成人销售价(单位:分)
  • └ adult_tax
  • Number
  • 50000
  • 成人税(单位:分)
  • └ child_price
  • Number
  • 100000
  • 儿童销售价(单位:分)
  • └ child_tax
  • Number
  • 10000
  • 儿童税(单位:分)
  • journeys
  • Journey []
  • 行程信息
  • flight_segments
  • FlightSegment []
  • 航段信息
  • └ arr_airport
  • String
  • HKG
  • 到达机场
  • └ arr_city
  • String
  • HKG
  • 到达城市
  • └ arr_term
  • String
  • 3
  • 到达航站楼
  • └ arr_time
  • String
  • 2018-06-23 10:10:00
  • 到达时间
  • └ cabin
  • String
  • K
  • 舱位
  • └ cabin_class
  • String
  • Y
  • 舱位等级(Y:经济舱;S:超值经济舱;C:公务舱;F:头等舱)
  • └ cabin_number
  • String
  • 5
  • 舱位剩余座位数:0~9:剩余0~9个座位;A:大于9个座位(个别航司大于4是A)
  • └ code_share
  • Boolean
  • false
  • 是否共享
  • └ dep_airport
  • String
  • PEK
  • 出发机场
  • └ dep_city
  • String
  • HKG
  • 出发城市
  • └ dep_term
  • String
  • T3
  • 出发航站楼
  • └ dep_time
  • String
  • 2017-06-23 10:10:00
  • 出发时间
  • └ duration
  • Number
  • 120
  • 飞行时长(单位:分钟)
  • └ equip_type
  • String
  • 333
  • 机型
  • └ marketing_airline
  • String
  • MU
  • 市场航司
  • └ marketing_flight_no
  • String
  • MU1234
  • 市场航班号
  • └ meal
  • Number
  • 1
  • 餐食
  • └ operating_airline
  • String
  • CA
  • 承运航司
  • └ operating_flight_no
  • String
  • CA1234
  • 承运航班号
  • └ seq_id
  • Number
  • 0
  • 航段id,从0开始
  • └ stop_city
  • String
  • CTU,XMN
  • 经停城市,多个用“,”分隔
  • └ seq_id
  • Number
  • 0
  • 航程id,从0开始
  • └ product_code
  • Number
  • 1
  • 废弃
  • └ search_key
  • String
  • sesgrshreee
  • searchKey
  • └ product_attr
  • Number
  • 3
  • 请转换成二进制格式,从右往左数,第1位表示是否自营,第2位表示是否金牌,第3位表示是否特卖,第4位表示是否旗舰店,第5位表示是否极速,第6位表示是否标准退改签,第7位表示是否延迟出票 举例:“10”代表金牌,“11”代表 自营+金牌,“100101”代表 自营+特卖+标准退改签, “110000”代表 极速+标准退改签。(当金牌产品是最低票价时,特卖产品不再出现)
  • └ invoice_type
  • Number
  • 9
  • 行程单类型: 9:等额行程单 7:差额行程单发票 5:旅行发票 3:电子行程单 100:仅旗舰店使用
  • └ need_visa
  • Boolean
  • false
  • 是否需要过境签
  • └ visa_notice
  • String
  • 约翰内斯堡--过境签提示:持中国护照旅客,需提前办理有效过境或入境签证,请确认签证无误后再购票。
  • 当需要过境签时,过境签提示
  • └ success
  • Boolean
  • true
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripIeTicketServiceSearchRequest req = new AlitripIeTicketServiceSearchRequest();
AlitripIeTicketServiceSearchRequest.SearchRq obj1 = new AlitripIeTicketServiceSearchRequest.SearchRq();
obj1.setCabinType(0L);
List<AlitripIeTicketServiceSearchRequest.OdInfo> list3 = new ArrayList<AlitripIeTicketServiceSearchRequest.OdInfo>();
AlitripIeTicketServiceSearchRequest.OdInfo obj4 = new AlitripIeTicketServiceSearchRequest.OdInfo();
list3.add(obj4);
obj4.setArrCityCode("HKG");
obj4.setDepCityCode("BJS");
obj4.setDepDate("2017-05-26");
List<AlitripIeTicketServiceSearchRequest.SelectedFlight> list7 = new ArrayList<AlitripIeTicketServiceSearchRequest.SelectedFlight>();
AlitripIeTicketServiceSearchRequest.SelectedFlight obj8 = new AlitripIeTicketServiceSearchRequest.SelectedFlight();
list7.add(obj8);
obj8.setArrAirport("HKG");
obj8.setDepAirport("PEK");
obj8.setFlightTime("2017-05-26 20:00:00");
obj8.setMarketFlightNo("HX313");
obj8.setOperatFlightNo("HX313");
obj8.setCabinCode("J");
list5.setSelectedFlights(list7);
obj1.setOdInfo(list3);
obj1.setPassengerNum(3L);
obj1.setTraceId("datgaegeewe");
obj1.setTripType(1L);
obj1.setNeedResultNum(200L);
obj1.setProductSelectionCode(4L);
obj1.setSearchType(0L);
obj1.setOnlyShopNames("飞猪旅行机票自营");
obj1.setIgnoredShopNames("飞猪旅行机票自营");
obj1.setProductSelectCodes(new Long[] { 8, 16 };
);
obj1.setOriginalPnrFirst(false);
req.setSearchRq(obj1);
AlitripIeTicketServiceSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_ie_ticket_service_search_response>
    <result>
        <error_code>1001</error_code>
        <error_msg>系统错误</error_msg>
        <products>
            <product>
                <adult_price>150000</adult_price>
                <adult_tax>50000</adult_tax>
                <child_price>100000</child_price>
                <child_tax>10000</child_tax>
                <journeys>
                    <journey>
                        <flight_segments>
                            <flight_segment>
                                <arr_airport>HKG</arr_airport>
                                <arr_city>HKG</arr_city>
                                <arr_term>3</arr_term>
                                <arr_time>2018-06-23 10:10:00</arr_time>
                                <cabin>K</cabin>
                                <cabin_class>Y</cabin_class>
                                <cabin_number>5</cabin_number>
                                <code_share>false</code_share>
                                <dep_airport>PEK</dep_airport>
                                <dep_city>HKG</dep_city>
                                <dep_term>T3</dep_term>
                                <dep_time>2017-06-23 10:10:00</dep_time>
                                <duration>120</duration>
                                <equip_type>333</equip_type>
                                <marketing_airline>MU</marketing_airline>
                                <marketing_flight_no>MU1234</marketing_flight_no>
                                <meal>1</meal>
                                <operating_airline>CA</operating_airline>
                                <operating_flight_no>CA1234</operating_flight_no>
                                <seq_id>0</seq_id>
                                <stop_city>CTU,XMN</stop_city>
                            </flight_segment>
                        </flight_segments>
                        <seq_id>0</seq_id>
                    </journey>
                </journeys>
                <product_code>1</product_code>
                <search_key>sesgrshreee</search_key>
                <product_attr>3</product_attr>
                <invoice_type>9</invoice_type>
                <need_visa>false</need_visa>
                <visa_notice>约翰内斯堡--过境签提示:持中国护照旅客,需提前办理有效过境或入境签证,请确认签证无误后再购票。</visa_notice>
            </product>
        </products>
        <success>true</success>
    </result>
</alitrip_ie_ticket_service_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

返回
顶部