淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
create_promotion_param	CreatePromotionParam	必须			促销活动对象
└ promotion_rule_id Number 可选 12345 促销规则Id,传值代表修改，不传代表新建 promotion_rules PromotionRule [] 必须活动规则对象当前一个活动ID只可传1条规则 └ length_of_stay Number 可选 3 连住天数,仅【连住优惠】活动类型需要传值且必须大于等于1，其他活动传值不生效。 book_date DateRange 可选预定日期 └ start String 可选 2024-06-11 开始日期，不传默认今天 └ end String 可选 2024-06-12 结束日期，不传默认今天+10年 └ stay_weekdays String [] 必须 [1,0,1,1,1,0,1] 入住时间的适用星期，周一到周日，适用1，不适用是0, 不支持所有日期都设置0 └ min_advance_day Number 可选 1 提前预订天数，仅【早订优惠】时需要传值,需要大于等于1，其他活动传值不生效。 book_time TimeRange 可选限时特惠、今夜甩卖（尾房）必传预订时间点，其他活动类型传了不生效。 └ start_time String 可选 14:00:00 开始时间,今夜甩卖 start_time 最早开始时间 14:00,限时特惠活动预订时间限当天，start_time最早开始时间 00:00:00 └ end_time String 可选 16:00:00 今夜甩卖支持end_time 如果到第二天的凌晨，则需+24h，如第二天凌晨4点，即传28:00:00，最大到31:00:00；限时特惠活动预订时间限当天end_time最大为23:59:59。 un_stay_date DateRange [] 可选 [{"start":"2024-06-01","end":"2024-06-02"},{"start":"2024-07-01","end":"2024-07-02"}] 不生效日期，支持传多段，最大限制10段 └ start String 可选 2024-06-01 开始时间 └ end String 可选 2024-06-02 结束时间 └ discount_value Number 必须 20 优惠值，与discount_type 使用。优惠20%，discount_value = 20，discount_type = 1；立减20元，discount_value = 2000，discount_type = 2；表示立减20元，原价200元，优惠后的金额为180元。 stay_date DateRange 必须促销限制的入住时间范围 └ start String 必须 2024-06-01 开始入住时间 └ end String 必须 2024-06-02 结束入住时间 └ discount_type Number 必须 1 折扣类型，1 代表折扣，2 代表立减，创建后不支持修改 └ promotion_code String 必须 4151 促销类别代码: [天天特惠 4151]， [早订优惠 4154]， [连住优惠 4153]， [限时特惠 4152]， [今夜甩卖 4367]， [门店新客 4155]， [出行特惠 4322] 活动创建成功后，不可修改活动类型。

名称	类型	示例值	描述
result	ResultSet		营销活动创建结果
└ promotion_rule_id Number 12345 促销活动ID，创建活动会返回，更新不返回 └ error_code String isv.invalid-parameter:NOTNULL 错误码 └ error_msg String 参数不能为空错误信息 └ success Boolean true 是否成功，true代表成功 └ trace_id String 122334232 日志id

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelPromotionCreateRequest req = new XhotelPromotionCreateRequest();
XhotelPromotionCreateRequest.CreatePromotionParam obj1 = new XhotelPromotionCreateRequest.CreatePromotionParam();
obj1.setPromotionRuleId(12345L);
List<XhotelPromotionCreateRequest.PromotionRule> list3 = new ArrayList<XhotelPromotionCreateRequest.PromotionRule>();
XhotelPromotionCreateRequest.PromotionRule obj4 = new XhotelPromotionCreateRequest.PromotionRule();
list3.add(obj4);
obj4.setLengthOfStay(3L);
XhotelPromotionCreateRequest.DateRange obj6 = new XhotelPromotionCreateRequest.DateRange();
obj6.setStart("2024-06-11");
obj6.setEnd("2024-06-12");
list5.setBookDate(obj6);
obj4.setStayWeekdays("1,0,1,1,1,0,1");
obj4.setMinAdvanceDay(1L);
XhotelPromotionCreateRequest.TimeRange obj8 = new XhotelPromotionCreateRequest.TimeRange();
obj8.setStartTime("14:00:00");
obj8.setEndTime("16:00:00");
list7.setBookTime(obj8);
List<XhotelPromotionCreateRequest.DateRange> list11 = new ArrayList<XhotelPromotionCreateRequest.DateRange>();
XhotelPromotionCreateRequest.DateRange obj12 = new XhotelPromotionCreateRequest.DateRange();
list11.add(obj12);
obj12.setStart("2024-06-01");
obj12.setEnd("2024-06-02");
list9.setUnStayDate(list11);
obj4.setDiscountValue(20L);
XhotelPromotionCreateRequest.DateRange obj14 = new XhotelPromotionCreateRequest.DateRange();
obj14.setStart("2024-06-01");
obj14.setEnd("2024-06-02");
list13.setStayDate(obj14);
obj1.setPromotionRules(list3);
obj1.setDiscountType(1L);
obj1.setPromotionCode("4151");
req.setCreatePromotionParam(obj1);
XhotelPromotionCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<xhotel_promotion_create_response>
    <result>
        <promotion_rule_id>12345</promotion_rule_id>
        <error_code>isv.invalid-parameter:NOTNULL</error_code>
        <error_msg>参数不能为空</error_msg>
        <success>true</success>
        <trace_id>122334232</trace_id>
    </result>
</xhotel_promotion_create_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测试工具错误码查询工具 SDK下载

开放平台

酒店商品API

taobao.xhotel.promotion.create (新增/更新营销活动)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ