文档中心 > API类目 > 本地生活API

alibaba.alsc.crm.marketing.lottery (抽奖)

用于用户抽奖(奖品是商家的优惠券)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
activity_id String 必须 123 活动id
brand_id String 可选 123 品牌id(brand_id和outer_brandId必传其一)
customer_id String 必须 123 会员id
operator_id String 可选 123 操作人
operator_name String 可选 123 操作人名称
out_brand_id String 可选 123 外部品牌id
out_shop_id String 可选 123 外部门店id
request_id String 可选 21313232 请求幂等id
shop_id String 可选 123 门店id

响应参数

名称 类型 示例值 描述
result CommonResult Object 接口结果
  • └ biz_success
  • Boolean
  • true
  • 接口调用是否成功
  • result
  • PrizeInfo
  • Object
  • 奖品信息
  • prize_item_info_list
  • PrizeItemInfo []
  • List
  • 奖品列表
  • └ denomination
  • String
  • 1
  • 优惠券额度
  • └ prize_level
  • Number
  • 1
  • 几等奖
  • └ prize_name
  • String
  • 优惠券
  • 奖品名称
  • └ voucher_ids
  • String []
  • ["1"]
  • 券实例id
  • └ voucher_name
  • String
  • 优惠券
  • 优惠券名称
  • └ voucher_type
  • String
  • 代金券
  • 优惠券类型
  • └ win_prize
  • Boolean
  • true
  • 是否中奖
  • └ result_code
  • String
  • null
  • 错误码
  • └ result_desc
  • String
  • 人气大爆发,一会接待您
  • 错误描述
  • └ result_view
  • String
  • 人气大爆发,一会接待您
  • 错误展示

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscCrmMarketingLotteryRequest req = new AlibabaAlscCrmMarketingLotteryRequest();
req.setActivityId("123");
req.setBrandId("123");
req.setCustomerId("123");
req.setOperatorId("123");
req.setOperatorName("123");
req.setOutBrandId("123");
req.setOutShopId("123");
req.setRequestId("21313232");
req.setShopId("123");
AlibabaAlscCrmMarketingLotteryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alsc_crm_marketing_lottery_response>
    <result>
        <biz_success>true</biz_success>
        <result>
            <prize_item_info_list>
                <prize_item_info>
                    <denomination>1</denomination>
                    <prize_level>1</prize_level>
                    <prize_name>优惠券</prize_name>
                    <voucher_ids>
                        <string>[&quot;1&quot;]</string>
                    </voucher_ids>
                    <voucher_name>优惠券</voucher_name>
                    <voucher_type>代金券</voucher_type>
                </prize_item_info>
            </prize_item_info_list>
            <win_prize>true</win_prize>
        </result>
        <result_code>null</result_code>
        <result_desc>人气大爆发,一会接待您</result_desc>
        <result_view>人气大爆发,一会接待您</result_view>
    </result>
</alibaba_alsc_crm_marketing_lottery_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

返回
顶部