文档中心 > API类目 > 五道口营销域

alibaba.hm.marketing.fullrange.createactivity (创建全场活动)

创建全场活动

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param FullRangeActivity 必须 创建活动请求入参
  • limit_info
  • LimitInfo
  • 可选
  • 通用限购信息,-1为不限制,默认为不限制
  • └ daily_limit_cnt
  • Number
  • 可选
  • 30
  • 活动每日总限购
  • └ user_daily_limit_cnt
  • Number
  • 可选
  • 2
  • 每人每日限购
  • └ user_limit_cnt
  • Number
  • 可选
  • 10
  • 每人活动期间总限购
  • └ total_limit_cnt
  • Number
  • 可选
  • 100
  • 活动期间总限购
  • └ terminals
  • String []
  • 必须
  • [1,2]
  • 优惠适用场景[APP|POS|POS+APP分别对应的值为1|2|1,2]
  • └ out_act_id
  • String
  • 可选
  • sanjiang170907
  • 商家活动id
  • └ shop_ids
  • String []
  • 必须
  • [123,456]
  • 参加活动的渠道店ids
  • └ end_time
  • Number
  • 必须
  • 1506513600000
  • 活动结束时间,时间戳
  • rule_stairs
  • Rulestairs []
  • 必须
  • 活动的梯度列表
  • └ amount_at
  • Boolean
  • 可选
  • false
  • 是否使用满元条件,不能与满件、N件Y折同时使用。此选项为true时,countAt和countBegin必须为false
  • └ amount
  • Number
  • 可选
  • 700
  • 满多少元[单位为分,传入700,代表满7元],amountAt为true时,必须设置
  • └ can_extra_item_num
  • Number
  • 可选
  • 1
  • 可换购的数量
  • └ start_time
  • Number
  • 必须
  • 1503835200000
  • 活动开始时间,时间戳
  • └ description
  • String
  • 必须
  • 活动描述
  • 活动详情描述,不超过30个英文字符
  • └ activity_name
  • String
  • 必须
  • 活动名称
  • 活动名称,不超过10个英文字符
  • └ merchant_crowd_code
  • String
  • 可选
  • OLD_USER
  • 商家人群编码
  • └ txd_crowd_code
  • String
  • 可选
  • ~OLD_USER
  • 淘鲜达人群编码

响应参数

名称 类型 示例值 描述
result MarketResult 创建活动返回结果
  • └ message
  • String
  • 请求参数非法
  • 错误信息
  • └ error_code
  • String
  • REQUEST_PARAM_ERROR
  • 错误码
  • └ data
  • Number
  • 124135
  • 创建成功时会返回五道口活动id
  • └ success
  • Boolean
  • true
  • 创建活动是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHmMarketingFullrangeCreateactivityRequest req = new AlibabaHmMarketingFullrangeCreateactivityRequest();
AlibabaHmMarketingFullrangeCreateactivityRequest.FullRangeActivity obj1 = new AlibabaHmMarketingFullrangeCreateactivityRequest.FullRangeActivity();
AlibabaHmMarketingFullrangeCreateactivityRequest.LimitInfo obj2 = new AlibabaHmMarketingFullrangeCreateactivityRequest.LimitInfo();
obj2.setDailyLimitCnt(30L);
obj2.setUserDailyLimitCnt(2L);
obj2.setUserLimitCnt(10L);
obj2.setTotalLimitCnt(100L);
obj1.setLimitInfo(obj2);
obj1.setTerminals("1,2");
obj1.setOutActId("sanjiang170907");
obj1.setShopIds("123,456");
obj1.setEndTime(1506513600000L);
List<AlibabaHmMarketingFullrangeCreateactivityRequest.Rulestairs> list4 = new ArrayList<AlibabaHmMarketingFullrangeCreateactivityRequest.Rulestairs>();
AlibabaHmMarketingFullrangeCreateactivityRequest.Rulestairs obj5 = new AlibabaHmMarketingFullrangeCreateactivityRequest.Rulestairs();
list4.add(obj5);
obj5.setAmountAt(false);
obj5.setAmount(700L);
obj5.setCanExtraItemNum(1L);
obj1.setRuleStairs(list4);
obj1.setStartTime(1503835200000L);
obj1.setDescription("活动描述");
obj1.setActivityName("活动名称");
obj1.setMerchantCrowdCode("OLD_USER");
obj1.setTxdCrowdCode("~OLD_USER");
req.setParam(obj1);
AlibabaHmMarketingFullrangeCreateactivityResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_hm_marketing_fullrange_createactivity_response>
    <result>
        <message>请求参数非法</message>
        <error_code>REQUEST_PARAM_ERROR</error_code>
        <data>124135</data>
        <success>true</success>
    </result>
</alibaba_hm_marketing_fullrange_createactivity_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

返回
顶部