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

taobao.ovs.tbk.item.single.convert (海外淘宝客pdp转链api)

海外淘宝客pdp转链api

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
unid String 可选 123 渠道自定义ID
item_id String 可选 fjdashkhie-r89juoiu 商品ID(优先级低于详情页链接内包含的itemId)
adzone_id Number 可选 123 推广位id,mm_xx_xx_xx pid三段式中的第三段
url String 可选 https://item.taobao.com/item.htm?id=fjdashkhie-r89juoiu 淘宝详情页链接
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 预估最低佣金率(%)
    campaign_type Number 2 计划类型,0代表通用计划,1代表定向计划,2代表鹊桥计划,3代表营销计划
    coupon_info String 满16元减10元 优惠券面额
    item_id String fjdashkhie-r89juoiu 商品id
    max_commission_rate String 20.3 常规佣金率(%)
    coupon_total_count Number 8000 优惠券总量
    coupon_end_time String 2016-09-26 优惠券结束时间
    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);
    OvsTbkItemSingleConvertRequest req = new OvsTbkItemSingleConvertRequest();
    req.setUnid("123");
    req.setItemId("fjdashkhie-r89juoiu");
    req.setAdzoneId(123L);
    req.setUrl("https://item.taobao.com/item.htm?id=fjdashkhie-r89juoiu");
    req.setPlatform(1L);
    OvsTbkItemSingleConvertResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <ovs_tbk_item_single_convert_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>
        <item_id>fjdashkhie-r89juoiu</item_id>
        <max_commission_rate>20.3</max_commission_rate>
        <coupon_total_count>8000</coupon_total_count>
        <coupon_end_time>2016-09-26</coupon_end_time>
        <coupon_type>1</coupon_type>
        <coupon_start_time>2016-09-25</coupon_start_time>
        <category_id>1</category_id>
    </ovs_tbk_item_single_convert_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

    返回
    顶部