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

taobao.ovs.tbk.item.convert.get (海外淘宝客-推广者-商品链接转换-V2)

海外淘宝客pdp转链api

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 可选 123 商品ID(优先级低于详情页链接内包含的itemId)
unid String 可选 123 渠道自定义ID
adzone_id Number 必须 123 推广位id,mm_xx_xx_xx pid三段式中的第三段
url String 可选 https://item.taobao.com/item.htm?id=577542476710 淘宝详情页链接
platform Number 可选 1
  • 默认值:1
  • 1:PC,2:无线,默认:1

    响应参数

    名称 类型 示例值 描述
    click_url String https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1 优先透出商品优惠券推广链接,若无则透出商品淘客链接
    coupon_remain_count Number 6859 优惠券剩余量
    min_commission_rate String 20.3 当入参special_id、relation_id、external_id时,该字段展示预估最低佣金率(%)
    campaign_type Number 2 计划类型,0代表通用计划,1代表定向计划,2代表鹊桥计划,3代表营销计划
    coupon_info String 满16元减10元 优惠券面额
    max_commission_rate String 20.3 当不入参special_id、relation_id、external_id时,展示常规佣金率(%)
    coupon_total_count Number 8000 优惠券总量
    coupon_end_time String 2016-09-26 优惠券结束时间
    item_id Number 524136796550 商品id
    coupon_type Number 1 优惠券(商品优惠券推广链接中的券)类型,1 公开券,2 私有券,3 妈妈券
    coupon_start_time String 2016-09-25 优惠券开始时间
    category_id Number 1 后台一级类目

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OvsTbkItemConvertGetRequest req = new OvsTbkItemConvertGetRequest();
    req.setItemId(123L);
    req.setUnid("123");
    req.setAdzoneId(123L);
    req.setUrl("https://item.taobao.com/item.htm?id=577542476710");
    req.setPlatform(1L);
    OvsTbkItemConvertGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <ovs_tbk_item_convert_get_response>
        <click_url>https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&amp;pid=mm_26381042_12970066_52864659&amp;af=1</click_url>
        <coupon_remain_count>6859</coupon_remain_count>
        <min_commission_rate>20.3</min_commission_rate>
        <campaign_type>2</campaign_type>
        <coupon_info>满16元减10元</coupon_info>
        <max_commission_rate>20.3</max_commission_rate>
        <coupon_total_count>8000</coupon_total_count>
        <coupon_end_time>2016-09-26</coupon_end_time>
        <item_id>524136796550</item_id>
        <coupon_type>1</coupon_type>
        <coupon_start_time>2016-09-25</coupon_start_time>
        <category_id>1</category_id>
    </ovs_tbk_item_convert_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

    返回
    顶部