文档中心 > API类目 > 酒店商品API

taobao.xhotel.promotion.query (直连营销活动和绑定资源查询)

直连营销活动和绑定资源查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_promotion_param QueryPromotionParam 必须 查询活动请求
  • └ promotion_rule_id
  • Number
  • 可选
  • 12345
  • 促销规则Id
  • └ page_no
  • Number
  • 必须
  • 1
  • 页码
  • └ page_size
  • Number
  • 必须
  • 50
  • 每页大小,最大50
  • └ hotel_code
  • String
  • 可选
  • 01102
  • 酒店code

响应参数

名称 类型 示例值 描述
result QueryPromotionResult 查询结果
  • └ trace_id
  • String
  • 122334232
  • 日志id
  • └ total_count
  • Number
  • 50
  • 请求传promotion_rule_id,total_count 指酒店code总量;请求传hotel_code,total_count是指promotion_rule_id总量;请求传promotion_rule_id + hotel_code,total_count = 1。
  • direct_promotions
  • DirectPromotion []
  • 直连营销
  • └ promotion_rule_id
  • Number
  • 12345
  • 促销规则Id
  • promotion_rules
  • PromotionRule []
  • 促销规则
  • └ length_of_stay
  • Number
  • 3
  • 连住天数
  • book_date
  • DateRange
  • 预定日期
  • └ start
  • String
  • 2024-06-11
  • 开始入住时间
  • └ end
  • String
  • 2024-06-12
  • 截止入住时间
  • └ stay_weekdays
  • String []
  • 入住时间的适用星期
  • └ min_advance_day
  • Number
  • 1
  • 提前预订天数
  • book_time
  • TimeRange
  • 预定时间
  • └ start_time
  • String
  • 14:00:00
  • 开始时间
  • └ end_time
  • String
  • 16:00:00
  • 结束时间
  • un_stay_date
  • DateRange []
  • 不生效日期
  • └ start
  • String
  • 2024-06-01
  • 开始时间
  • └ end
  • String
  • 2024-06-02
  • 结束时间
  • └ discount_value
  • Number
  • 20
  • 1 Fixed:固定金额,单位分,1000;0Percentage: 折扣比例,20,表示优惠20%,比如100元,优惠20%后为 80元。
  • stay_date
  • DateRange
  • 促销限制的入住时间范围
  • └ start
  • String
  • 2024-06-01
  • 开始入住时间
  • └ end
  • String
  • 2024-06-02
  • 结束入住时间
  • └ promotion_code
  • Number
  • 4151
  • 促销类别代码
  • resources
  • PromotionResource []
  • 活动绑定资源
  • rooms
  • ResourceRoom []
  • 房型信息
  • └ rate_plan_codes
  • String []
  • 供应商rpcodes
  • └ room_code
  • String
  • 45875
  • 供应商房型code
  • └ hotel_code
  • String
  • 12321
  • 供应商酒店code
  • └ discount_type
  • Number
  • 1
  • 促销金额计算方式, 0 Percentage | 1 Fixed; 暂时支持固定金额 Fixed:固定金额 Percentage: 折扣比例
  • └ error_msg
  • String
  • 参数不能为空
  • 错误描述
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ error_code
  • String
  • isv.invalid-parameter: NOTNULL
  • 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelPromotionQueryRequest req = new XhotelPromotionQueryRequest();
XhotelPromotionQueryRequest.QueryPromotionParam obj1 = new XhotelPromotionQueryRequest.QueryPromotionParam();
obj1.setPromotionRuleId(12345L);
obj1.setPageNo(1L);
obj1.setPageSize(50L);
obj1.setHotelCode("01102");
req.setQueryPromotionParam(obj1);
XhotelPromotionQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_promotion_query_response>
    <result>
        <trace_id>122334232</trace_id>
        <total_count>50</total_count>
        <direct_promotions>
            <direct_promotion>
                <promotion_rule_id>12345</promotion_rule_id>
                <promotion_rules>
                    <promotion_rule>
                        <length_of_stay>3</length_of_stay>
                        <book_date>
                            <start>2024-06-11</start>
                            <end>2024-06-12</end>
                        </book_date>
                        <min_advance_day>1</min_advance_day>
                        <book_time>
                            <start_time>14:00:00</start_time>
                            <end_time>16:00:00</end_time>
                        </book_time>
                        <un_stay_date>
                            <date_range>
                                <start>2024-06-01</start>
                                <end>2024-06-02</end>
                            </date_range>
                        </un_stay_date>
                        <discount_value>20</discount_value>
                        <stay_date>
                            <start>2024-06-01</start>
                            <end>2024-06-02</end>
                        </stay_date>
                    </promotion_rule>
                </promotion_rules>
                <promotion_code>4151</promotion_code>
                <resources>
                    <promotion_resource>
                        <rooms>
                            <resource_room>
                                <room_code>45875</room_code>
                            </resource_room>
                        </rooms>
                        <hotel_code>12321</hotel_code>
                    </promotion_resource>
                </resources>
                <discount_type>1</discount_type>
            </direct_promotion>
        </direct_promotions>
        <error_msg>参数不能为空</error_msg>
        <success>true</success>
        <error_code>isv.invalid-parameter: NOTNULL</error_code>
    </result>
</xhotel_promotion_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

返回
顶部