文档中心 > API类目 > 手淘互动API

taobao.hudong.achievement.shop.discount.query (淘宝成就系统优惠券信息通过开放接口提供店铺小程序查询)

淘宝成就系统优惠券信息通过开放接口提供店铺小程序查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
lottery_item_id Number 必须 1 商品id
x_time_draw_count Number 必须 5 多抽次数
open_id String 必须 AAENVKOdAOIduo9TH9oBSasY 用户openId
full_draw_remain_count Number 必须 10 抽整盒剩余的次数

响应参数

名称 类型 示例值 描述
biz_success Boolean true 调用成功标识
model LotteryDiscountDTO [] 抽赏数据列表
  • └ origin_amount
  • Number
  • 5999
  • 原价
  • └ price_unit
  • String
  • FEN
  • 金钱单位
  • └ benefit_type_name
  • String
  • 新人优惠
  • 优惠名称
  • └ draw_type
  • String
  • ONE_TIME、X_TIME、FULL
  • 抽赏类型(单抽、多抽、抽整盒)
  • └ discount_amount
  • Number
  • 3599
  • 折扣价
msg_info String 调用成功 msgInfo
msg_code String succes msgCode

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
HudongAchievementShopDiscountQueryRequest req = new HudongAchievementShopDiscountQueryRequest();
req.setLotteryItemId(1L);
req.setXTimeDrawCount(5L);
req.setOpenId("AAENVKOdAOIduo9TH9oBSasY");
req.setFullDrawRemainCount(10L);
HudongAchievementShopDiscountQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<hudong_achievement_shop_discount_query_response>
    <biz_success>true</biz_success>
    <model>
        <lottery_discount_d_t_o>
            <origin_amount>5999</origin_amount>
            <price_unit>FEN</price_unit>
            <benefit_type_name>新人优惠</benefit_type_name>
            <draw_type>ONE_TIME、X_TIME、FULL</draw_type>
            <discount_amount>3599</discount_amount>
        </lottery_discount_d_t_o>
    </model>
    <msg_info>调用成功</msg_info>
    <msg_code>succes</msg_code>
</hudong_achievement_shop_discount_query_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

返回
顶部