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

alibaba.hm.marketing.fullrange.queryactivity (全场活动查询活动)

全场活动查询活动

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 CommonActivityParam 必须 查询活动入参
  • └ activity_id
  • Number
  • 必须
  • 124135
  • 五道口活动id
  • └ out_act_id
  • String
  • 可选
  • sanjiang170907
  • 商家活动id

响应参数

名称 类型 示例值 描述
result MarketResult 查询返回结果
  • └ error_code
  • String
  • REQUEST_PARAM_ERROR
  • 错误码
  • data
  • ItemPoolActivity
  • 返回活动信息
  • limit_info
  • LimitInfo
  • 通用限购信息,-1为不限制,默认为不限制
  • └ user_limit_cnt
  • Number
  • 10
  • 每人活动期间总限购
  • └ user_daily_limit_cnt
  • Number
  • 2
  • 每人每日限购
  • └ daily_limit_cnt
  • Number
  • 30
  • 活动每日总限购
  • 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
  • 如果为换购活动,则代表此阶梯可换购的商品数量
  • └ out_act_id
  • String
  • sanjiang123123
  • 商家活动id
  • └ activity_id
  • Number
  • 123123
  • 报名活动Id
  • └ activity_name
  • String
  • 满30-10
  • 活动名称
  • └ description
  • String
  • 三江满件活动
  • 活动描述
  • └ start_time
  • Number
  • 1516441828483
  • startTime
  • └ end_time
  • Number
  • 1516441828483
  • endTime
  • └ terminals
  • Number []
  • [1,2]
  • 优惠适用场景:APP|POS|POS+APP 分别对应的值为1|2|1,2
  • └ member_limit
  • Number
  • 1
  • 会员维度活动参与人群限制:-1:不限制 1:会员专享 2:非会员专享
  • └ shop_ids
  • String []
  • ["123","345"]
  • shopIds
  • └ merchant_crowd_code
  • String
  • SANJDEM
  • merchantCrowdCode
  • └ txd_crowd_code
  • String
  • ~SANJDEM
  • txdCrowdCode
  • └ success
  • Boolean
  • true
  • 查询商品是否成功
  • └ message
  • String
  • 请求参数非法
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHmMarketingFullrangeQueryactivityRequest req = new AlibabaHmMarketingFullrangeQueryactivityRequest();
AlibabaHmMarketingFullrangeQueryactivityRequest.CommonActivityParam obj1 = new AlibabaHmMarketingFullrangeQueryactivityRequest.CommonActivityParam();
obj1.setActivityId(124135L);
obj1.setOutActId("sanjiang170907");
req.setParam0(obj1);
AlibabaHmMarketingFullrangeQueryactivityResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_hm_marketing_fullrange_queryactivity_response>
    <result>
        <error_code>REQUEST_PARAM_ERROR</error_code>
        <data>
            <limit_info>
                <user_limit_cnt>10</user_limit_cnt>
                <user_daily_limit_cnt>2</user_daily_limit_cnt>
                <daily_limit_cnt>30</daily_limit_cnt>
            </limit_info>
            <rule_stairs>
                <rulestairs>
                    <amount_at>false</amount_at>
                    <amount>700</amount>
                    <can_extra_item_num>1</can_extra_item_num>
                </rulestairs>
            </rule_stairs>
            <out_act_id>sanjiang123123</out_act_id>
            <activity_id>123123</activity_id>
            <activity_name>满30-10</activity_name>
            <description>三江满件活动</description>
            <start_time>1516441828483</start_time>
            <end_time>1516441828483</end_time>
            <terminals>
                <number>[1</number>
                <number>2]</number>
            </terminals>
            <member_limit>1</member_limit>
            <shop_ids>
                <string>[&quot;123&quot;</string>
                <string>&quot;345&quot;]</string>
            </shop_ids>
            <merchant_crowd_code>SANJDEM</merchant_crowd_code>
            <txd_crowd_code>~SANJDEM</txd_crowd_code>
        </data>
        <success>true</success>
        <message>请求参数非法</message>
    </result>
</alibaba_hm_marketing_fullrange_queryactivity_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

返回
顶部