文档中心 > API类目 > 商家营销中心API

taobao.singletreasure.activity.create (活动创建接口)

创建优惠活动

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
activity_info ActivityInfoCreateDto 必须 系统入参
  • └ start_time
  • String
  • 必须
  • 2017-09-05 22:43:46
  • 开始时间:需要早于当天零点
  • └ discount_type
  • Number
  • 必须
  • 2
  • 优惠类型 促销价:1;打折:2;减钱:4
  • └ free_post
  • Boolean
  • 可选
  • true
  • 是否包邮
  • └ description
  • String
  • 必须
  • 单品优惠活动
  • 活动描述
  • └ name
  • String
  • 必须
  • 年货价
  • 活动名称
  • └ crowd_id
  • String
  • 可选
  • 34580083423
  • 人群 id
  • └ promotion_level
  • Number
  • 必须
  • 1
  • 优惠等级 商品:1; 店铺:2; SKU:3
  • └ end_time
  • String
  • 必须
  • 2017-09-05 22:43:46
  • 结束时间
  • └ exclude_areas
  • String
  • 可选
  • 990100,110000
  • 不包邮地区
  • └ activity_type
  • Number
  • 可选
  • 1
  • 活动类型, 普通活动: 1, 官方活动: 2

响应参数

名称 类型 示例值 描述
result ResultDto result
  • └ message
  • String
  • 成功
  • 错误信息
  • └ data
  • Number
  • 123456
  • 新建套餐 id
  • └ code
  • Number
  • null
  • 错误编码
  • └ success
  • Boolean
  • false
  • 系统执行成功与否

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SingletreasureActivityCreateRequest req = new SingletreasureActivityCreateRequest();
SingletreasureActivityCreateRequest.ActivityInfoCreateDto obj1 = new SingletreasureActivityCreateRequest.ActivityInfoCreateDto();
obj1.setStartTime("2017-09-05 22:43:46");
obj1.setDiscountType(2L);
obj1.setFreePost(true);
obj1.setDescription("单品优惠活动");
obj1.setName("年货价");
obj1.setCrowdId("34580083423");
obj1.setPromotionLevel(1L);
obj1.setEndTime("2017-09-05 22:43:46");
obj1.setExcludeAreas("990100,110000");
obj1.setActivityType(1L);
req.setActivityInfo(obj1);
SingletreasureActivityCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<singletreasure_activity_create_response>
    <result>
        <message>成功</message>
        <data>123456</data>
        <code>null</code>
        <success>false</success>
    </result>
</singletreasure_activity_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工具

如何获得此API

FAQ

返回
顶部