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

alibaba.hm.marketing.itemdiscount.additem (报名特价商品)

在商品特价活动中报名特价商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 ItemDiscountSku 必须 商品对象
  • 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
  • 活动期间总限购
  • └ daily_limit_cnt_double
  • String
  • 可选
  • 1.2
  • 活动每日总限购(非标小数)
  • └ user_daily_limit_cnt_double
  • String
  • 可选
  • 2.3
  • 每人每日限购(非标小数)
  • └ user_limit_cnt_double
  • String
  • 可选
  • 3.4
  • 每人活动期间总限购(非标小数)
  • └ total_limit_cnt_double
  • String
  • 可选
  • 4.5
  • 活动期间总限购(非标小数)
  • └ value
  • Number
  • 必须
  • 100
  • <优惠明细,分为单位>优惠类型为[减价],则代表直降金额[如700,表示商品直降7元];优惠券类型为[一口价],则代表一口价[如700,表示商品一口价为7元];优惠券类型为[打折],则代表折扣[如700,表示打7折]
  • └ sku_name
  • String
  • 可选
  • 商品名称
  • 商品名称
  • └ sku_code
  • String
  • 必须
  • 12513
  • 商品的skuCode
  • └ condition_num
  • Number
  • 可选
  • 1000
  • 门槛数量,金额值单位为分
  • └ condition_type
  • Number
  • 可选
  • 2
  • 门槛类型,2:累计消费金额,3:累计购买次数
param1 CommonActivityParam 必须 活动基本信息
  • └ activity_id
  • Number
  • 必须
  • 123456
  • 五道口活动id
  • └ out_act_id
  • String
  • 可选
  • sanjiang170907
  • 商家活动id
  • └ by_channel
  • Boolean
  • 可选
  • true
  • 是否自定义渠道同步
  • channel_config_list
  • ChannelConfig []
  • 可选
  • ""
  • 自定义同步的渠道配置
  • └ channel
  • String
  • 可选
  • 31
  • 淘鲜达:"31",饿了么:"3",京东到家:"26",美团外卖:"2"

响应参数

名称 类型 示例值 描述
result MarketResult 商品报名活动的返回结果
  • └ message
  • String
  • 请求参数非法
  • 错误信息
  • └ error_code
  • String
  • REQUEST_PARAM_ERROR
  • 错误码
  • data
  • ItemDiscountSku
  • 报名活动成功的商品详情
  • └ value
  • Number
  • 100
  • <优惠明细,分为单位>优惠类型为[减价],则代表直降金额[如700,表示商品直降7元];优惠券类型为[一口价],则代表一口价[如700,表示商品一口价为7元];优惠券类型为[打折],则代表折扣[如700,表示打7折]
  • └ sku_name
  • String
  • 商品名称
  • 商品名称
  • └ sku_code
  • String
  • 12513
  • 商品的skuCode
  • └ item_shop_relation
  • String
  • {2300929749296:1000847028}
  • 淘宝item和shop的对应关系, k-itemId, v-shopId
  • limit_info
  • LimitInfo
  • 通用限购信息,-1为不限制,默认为不限制
  • └ total_limit_cnt
  • Number
  • 100
  • 活动期间总限购
  • └ user_limit_cnt
  • Number
  • 10
  • 每人活动期间总限购
  • └ user_daily_limit_cnt
  • Number
  • 2
  • 每人每日限购
  • └ daily_limit_cnt
  • Number
  • 30
  • 活动每日总限购
  • └ total_limit_cnt_double
  • String
  • 1.2
  • 活动期间总限购(非标小数)
  • └ user_limit_cnt_double
  • String
  • 2.3
  • 每人活动期间总限购(非标小数)
  • └ user_daily_limit_cnt_double
  • String
  • 3.4
  • 每人每日限购(非标小数)
  • └ daily_limit_cnt_double
  • String
  • 4.5
  • 活动每日总限购(非标小数)
  • └ success
  • Boolean
  • true
  • 是否报名成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHmMarketingItemdiscountAdditemRequest req = new AlibabaHmMarketingItemdiscountAdditemRequest();
AlibabaHmMarketingItemdiscountAdditemRequest.ItemDiscountSku obj1 = new AlibabaHmMarketingItemdiscountAdditemRequest.ItemDiscountSku();
AlibabaHmMarketingItemdiscountAdditemRequest.LimitInfo obj2 = new AlibabaHmMarketingItemdiscountAdditemRequest.LimitInfo();
obj2.setDailyLimitCnt(30L);
obj2.setUserDailyLimitCnt(2L);
obj2.setUserLimitCnt(10L);
obj2.setTotalLimitCnt(100L);
obj2.setDailyLimitCntDouble("1.2");
obj2.setUserDailyLimitCntDouble("2.3");
obj2.setUserLimitCntDouble("3.4");
obj2.setTotalLimitCntDouble("4.5");
obj1.setLimitInfo(obj2);
obj1.setValue(100L);
obj1.setSkuName("商品名称");
obj1.setSkuCode("12513");
obj1.setConditionNum(1000L);
obj1.setConditionType(2L);
req.setParam0(obj1);
AlibabaHmMarketingItemdiscountAdditemRequest.CommonActivityParam obj3 = new AlibabaHmMarketingItemdiscountAdditemRequest.CommonActivityParam();
obj3.setActivityId(123456L);
obj3.setOutActId("sanjiang170907");
obj3.setByChannel(true);
List<AlibabaHmMarketingItemdiscountAdditemRequest.ChannelConfig> list5 = new ArrayList<AlibabaHmMarketingItemdiscountAdditemRequest.ChannelConfig>();
AlibabaHmMarketingItemdiscountAdditemRequest.ChannelConfig obj6 = new AlibabaHmMarketingItemdiscountAdditemRequest.ChannelConfig();
list5.add(obj6);
obj6.setChannel("31");
obj3.setChannelConfigList(list5);
req.setParam1(obj3);
AlibabaHmMarketingItemdiscountAdditemResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_hm_marketing_itemdiscount_additem_response>
    <result>
        <message>请求参数非法</message>
        <error_code>REQUEST_PARAM_ERROR</error_code>
        <data>
            <value>100</value>
            <sku_name>商品名称</sku_name>
            <sku_code>12513</sku_code>
            <item_shop_relation>{2300929749296:1000847028}</item_shop_relation>
            <limit_info>
                <total_limit_cnt>100</total_limit_cnt>
                <user_limit_cnt>10</user_limit_cnt>
                <user_daily_limit_cnt>2</user_daily_limit_cnt>
                <daily_limit_cnt>30</daily_limit_cnt>
                <total_limit_cnt_double>1.2</total_limit_cnt_double>
                <user_limit_cnt_double>2.3</user_limit_cnt_double>
                <user_daily_limit_cnt_double>3.4</user_daily_limit_cnt_double>
                <daily_limit_cnt_double>4.5</daily_limit_cnt_double>
            </limit_info>
        </data>
        <success>true</success>
    </result>
</alibaba_hm_marketing_itemdiscount_additem_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

返回
顶部