alitrip.policy.price.compare.query (国内国际比价信息查询)

国内国际比价信息查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
compare_price_query_dto ComparePriceQueryDTO 必须 比价查询参数
  • od_infos
  • OdInfoQueryDTO []
  • 必须
  • 航程信息
  • └ cabin_code
  • String
  • 可选
  • M
  • 舱位代码,多个用英文逗号分隔,仅国内比价可用
  • └ flight_no
  • String
  • 可选
  • HU7001
  • 航班号,输入航司和航班号,例如HU7001,多段航班使用英文逗号分隔
  • flight_date
  • DateTimestampPair
  • 必须
  • 航班日期
  • └ start
  • Number
  • 必须
  • 1724323173000
  • 航班开始日期
  • └ end
  • Number
  • 必须
  • 1724323173000
  • 航班结束日期
  • └ airline
  • String
  • 可选
  • CA
  • 航司二字码
  • └ dep_airport
  • String
  • 可选
  • CAN
  • 出发机场,机场三字码,国内比价时必填
  • └ arr_airport
  • String
  • 可选
  • PEK
  • 到达机场,机场三字码,国内比价时必填
  • └ dep_city
  • String
  • 可选
  • CTU
  • 出发城市,城市三字码,国际比价时必填
  • └ arr_city
  • String
  • 可选
  • SEL
  • 到达城市,城市三字码,国际比价时必填
  • └ transit_city
  • String
  • 可选
  • PUS
  • 中转城市,城市三字码,国际比价使用
  • └ index
  • Number
  • 必须
  • 0
  • 行程类型:0,去程;1,返程;国内业务暂时仅支持单程,默认为0
  • └ cabin_class
  • String
  • 可选
  • F
  • 舱位等级:F,头等舱;C,商务舱;Y,经济舱;P,超值经济舱;仅国际比价可用
  • └ agent_id
  • Number
  • 必须
  • 2052
  • 店铺id
  • └ biz_type
  • Number
  • 可选
  • 1
  • 业务类型:1,国内;2,国际;默认为1
  • └ support_code_share
  • Number
  • 可选
  • 0
  • 共享航班:0,不支持代码共享;1,支持代码共享;2,仅支持代码共享;仅国内比价可用
  • └ brand_grade
  • Number
  • 可选
  • 0
  • 航司品牌档位:0,仅最低档位;1,全部档位;国际比价时必填
  • └ product_types
  • String []
  • 可选
  • [0,1]
  • 产品类型;1、国内:0,普通;1,多人成行;2,学生专享;3,青年专享;4,老年专享;5,地区专享;6,会员;9,家庭套票;10,学生认证专享;11,年龄票。 2、国际:0,普通;1,多人成行;7,留学生;8,国籍;11,年龄票。根据业务类型选择,支持多个
  • └ policy_deploy_status
  • Number
  • 可选
  • 0
  • 政策投放情况:0,未投放;1,已投放,非最优惠;2,已投放,且为最优惠政策;为空表示不限制
  • └ trip_type
  • Number
  • 必须
  • 0
  • 行程类型:0,单程;1,往返;国内暂时仅支持单程
  • └ direct_transfer_type
  • Number
  • 必须
  • 0
  • 航程类型:0,直达;1,中转;国内暂时仅支持直达
  • └ sale_mode_codes
  • String []
  • 可选
  • [0,1]
  • 销售方式;1、国内:0,普通;1,旅行销售套餐1;2,旅行销售套餐2;3,旅行销售套餐3;4,返现-航司运价;5,返现-销售方包装;6,花呗卖家版。 2、国际:0,普通;6,花呗卖家版;7,金牌;8,极速;9,限时免费退;10,延时出票;11,延时出票二档;12,延时出票三档。根据业务类型选择,支持多个
  • └ supply_product_code
  • String []
  • 可选
  • ["ABCD"]
  • 产品码;投放模式填1时,此字段必填,仅支持单个,投放产品码参见比价页面上可见的产品码或咨询运营;举例:在页面可选择【普通产品(COMMON)】产品码,在此录入产品码为COMMON;仅国内比价可用
  • └ use_product_model
  • Number
  • 可选
  • 0
  • 投放模式;0,非产品码模式;1,供给产品码模式;默认为1,仅国内比价可用
  • └ baggage_type
  • Number
  • 可选
  • 1
  • 行李额;1,(0,15)kg;2,[15,30)kg;3,[30,+∞)kg;4,0kg;不填默认为全部。(0,15)kg:免费托运行李大于0,小于15kg;[15,30)kg:免费托运行李大于等于15,小于30kg;[30,+∞)kg:免费托运行李大于等于30kg;0kg:表示有航段无免费托运行李

响应参数

名称 类型 示例值 描述
result ResultDTO 返回信息
  • data
  • ComparePriceDTO []
  • 比价信息集合
  • od_infos
  • ComparePriceOdInfoDTO []
  • 航段信息
  • └ index
  • Number
  • 0
  • 行程标记:0,去程;1,回程
  • └ arr_dep
  • String
  • LHW-HAK
  • 航程信息,出发-到达
  • flight_dates
  • DatePair []
  • 航班日期
  • └ start
  • Date
  • 2024-08-26
  • 航班起始日期
  • └ end
  • Date
  • 2024-08-26
  • 航班结束日期
  • └ flight_nos
  • String
  • CZ6676
  • 航班号
  • └ cabin
  • String
  • M
  • 舱位代码
  • └ cabin_class
  • String
  • F
  • 舱位等级
  • └ can_sell
  • Boolean
  • true
  • 是否销售
  • └ lowest_sale_price
  • Number
  • 100
  • 外放最低营销定价,单位分
  • └ self_tax_price
  • Number
  • 100
  • 我的税费,单位分
  • └ policy_id
  • String
  • 123456
  • 我的政策Id
  • └ product_type
  • Number
  • 0
  • 产品类型;1、国内:0,普通;1,多人成行;2,学生专享;3,青年专享;4,老年专享;5,地区专享;6,会员;9,家庭套票;10,学生认证专享;11,年龄票。 2、国际:0,普通;1,多人成行;7,留学生;8,国籍;11,年龄票。
  • └ brand_grade
  • String
  • 0
  • 航司品牌档位:0,仅最低档位;1,全部档位;
  • └ compare_fare_id
  • String
  • 12345
  • 比较票价id
  • └ sale_mode_code
  • Number
  • 0
  • 销售方式;1、国内:0,普通;1,旅行销售套餐1;2,旅行销售套餐2;3,旅行销售套餐3;4,返现-航司运价;5,返现-销售方包装;6,花呗卖家版。 2、国际:0,普通;6,花呗卖家版;7,金牌;8,极速;9,限时免费退;10,延时出票;11,延时出票二档;12,延时出票三档。
  • └ policy_deploy_status
  • Number
  • 0
  • 政策投放情况:0,未投放;1,已投放,非最优惠;2,已投放且为最优惠政策
  • └ supply_product_name
  • String
  • 普通产品
  • 产品码类型
  • └ self_sale_price
  • Number
  • 100
  • 我的最低营销定价 单位分
  • └ policy_type
  • Number
  • 1
  • 报价类型;1、国内:普通政策;2,特殊政策;3,规则政策。2、国际:4,自有政策;5,直连报价;6,销售规则。
  • └ price_diff
  • Number
  • 50
  • 价差 单位分
  • └ compare_tax_price
  • Number
  • 10
  • 最低价的税费 单位分
  • └ baggage_type
  • Number
  • 1
  • 行李额;1,(0,15)kg;2,[15,30)kg;3,[30,+∞)kg;4,0kg;-1,未知。(0,15)kg:免费托运行李大于0,小于15kg;[15,30)kg:免费托运行李大于等于15,小于30kg;[30,+∞)kg:免费托运行李大于等于30kg;0kg:表示有航段无免费托运行李;未知:表示未查询到行李额
  • └ success
  • Boolean
  • true
  • 请求成功标识,成功:true,失败:false
  • └ error_code
  • String
  • 错误码
  • 响应code
  • └ error_msg
  • String
  • 错误信息
  • 响应msg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripPolicyPriceCompareQueryRequest req = new AlitripPolicyPriceCompareQueryRequest();
AlitripPolicyPriceCompareQueryRequest.ComparePriceQueryDTO obj1 = new AlitripPolicyPriceCompareQueryRequest.ComparePriceQueryDTO();
List<AlitripPolicyPriceCompareQueryRequest.OdInfoQueryDTO> list3 = new ArrayList<AlitripPolicyPriceCompareQueryRequest.OdInfoQueryDTO>();
AlitripPolicyPriceCompareQueryRequest.OdInfoQueryDTO obj4 = new AlitripPolicyPriceCompareQueryRequest.OdInfoQueryDTO();
list3.add(obj4);
obj4.setCabinCode("M");
obj4.setFlightNo("HU7001");
AlitripPolicyPriceCompareQueryRequest.DateTimestampPair obj6 = new AlitripPolicyPriceCompareQueryRequest.DateTimestampPair();
obj6.setStart(1724323173000L);
obj6.setEnd(1724323173000L);
list5.setFlightDate(obj6);
obj4.setAirline("CA");
obj4.setDepAirport("CAN");
obj4.setArrAirport("PEK");
obj4.setDepCity("CTU");
obj4.setArrCity("SEL");
obj4.setTransitCity("PUS");
obj4.setIndex(0L);
obj1.setOdInfos(list3);
obj1.setCabinClass("F");
obj1.setAgentId(2052L);
obj1.setBizType(1L);
obj1.setSupportCodeShare(0L);
obj1.setBrandGrade(0L);
obj1.setProductTypes("0,1");
obj1.setPolicyDeployStatus(0L);
obj1.setTripType(0L);
obj1.setDirectTransferType(0L);
obj1.setSaleModeCodes("0,1");
obj1.setSupplyProductCode(""ABCD"");
obj1.setUseProductModel(0L);
obj1.setBaggageType(1L);
req.setComparePriceQueryDto(obj1);
AlitripPolicyPriceCompareQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_policy_price_compare_query_response>
    <result>
        <data>
            <compare_price_d_t_o>
                <od_infos>
                    <compare_price_od_info_d_t_o>
                        <index>0</index>
                        <arr_dep>LHW-HAK</arr_dep>
                        <flight_dates>
                            <date_pair>
                                <start>2024-08-26</start>
                                <end>2024-08-26</end>
                            </date_pair>
                        </flight_dates>
                        <flight_nos>CZ6676</flight_nos>
                        <cabin>M</cabin>
                        <cabin_class>F</cabin_class>
                    </compare_price_od_info_d_t_o>
                </od_infos>
                <can_sell>true</can_sell>
                <lowest_sale_price>100</lowest_sale_price>
                <self_tax_price>100</self_tax_price>
                <policy_id>123456</policy_id>
                <product_type>0</product_type>
                <brand_grade>0</brand_grade>
                <compare_fare_id>12345</compare_fare_id>
                <sale_mode_code>0</sale_mode_code>
                <policy_deploy_status>0</policy_deploy_status>
                <supply_product_name>普通产品</supply_product_name>
                <self_sale_price>100</self_sale_price>
                <policy_type>1</policy_type>
                <price_diff>50</price_diff>
                <compare_tax_price>10</compare_tax_price>
                <baggage_type>1</baggage_type>
            </compare_price_d_t_o>
        </data>
        <success>true</success>
        <error_code>错误码</error_code>
        <error_msg>错误信息</error_msg>
    </result>
</alitrip_policy_price_compare_query_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

返回
顶部