文档中心 > API类目 > 海外-淘宝客API

taobao.ovs.tbk.coupon.get (海外淘宝客-公用-阿里妈妈推广券详情查询)

传入商品ID+券ID(券ID已知情况下),或者传入me参数,均可查询阿里妈妈推广券详细信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
activity_id String 可选 sdfwe3eefsdf 券ID
item_id Number 可选 123 商品ID
me String 可选 qXg3XtWCOSkGQASttHIRqe62AiBkZ4pvWY6tJg2JrUXcQLm7dJTvUGkZZ27JIlbwm50QiBUMH4bbLaGB9uZG%2BjKPu%2B%2B9tyZI8QkTzUh9LV2awXylEe5JjWPOg98pwnpN 带券ID与商品ID的加密串

响应参数

名称 类型 示例值 描述
result Object result result
  • └ coupon_total_count
  • Number
  • 30000
  • 优惠券总量
  • └ coupon_end_time
  • String
  • 2021-09-17
  • 优惠券结束时间
  • └ coupon_start_fee
  • String
  • 29.00
  • 优惠券门槛金额
  • └ coupon_remain_count
  • Number
  • 26996
  • 优惠券剩余量
  • └ coupon_amount
  • String
  • 10.00
  • 优惠券金额
  • └ coupon_activity_id
  • String
  • xsdss
  • 券ID
  • └ coupon_src_scene
  • Number
  • 1
  • 券类型,1 表示全网公开券,4 表示妈妈渠道券
  • └ coupon_type
  • Number
  • 0
  • 券属性,0表示店铺券,1表示单品券
  • └ coupon_start_time
  • String
  • 2021-09-11
  • 优惠券开始时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkCouponGetRequest req = new OvsTbkCouponGetRequest();
req.setActivityId("sdfwe3eefsdf");
req.setItemId(123L);
req.setMe("qXg3XtWCOSkGQASttHIRqe62AiBkZ4pvWY6tJg2JrUXcQLm7dJTvUGkZZ27JIlbwm50QiBUMH4bbLaGB9uZG%2BjKPu%2B%2B9tyZI8QkTzUh9LV2awXylEe5JjWPOg98pwnpN");
OvsTbkCouponGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ovs_tbk_coupon_get_response>
    <result>
        <coupon_total_count>30000</coupon_total_count>
        <coupon_end_time>2021-09-17</coupon_end_time>
        <coupon_start_fee>29.00</coupon_start_fee>
        <coupon_remain_count>26996</coupon_remain_count>
        <coupon_amount>10.00</coupon_amount>
        <coupon_activity_id>xsdss</coupon_activity_id>
        <coupon_src_scene>1</coupon_src_scene>
        <coupon_type>0</coupon_type>
        <coupon_start_time>2021-09-11</coupon_start_time>
    </result>
</ovs_tbk_coupon_get_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

返回
顶部