淘宝开放平台

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

海外-淘宝客API

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

【废弃】淘宝客-推广者-商品链接转换-V1，历史接口，请使用最新的接口：/tbk/material/item/link/convert。 -- [Deprecated] Single Item Link Conversion, The historical interface has been updated. Please use the latest interface: /tbk/material/item/link/convert.

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 可选 123 商品ID（优先级低于详情页链接内包含的itemId） -- Product ID (lower priority than itemId contained in the detail page link)
unid String 可选 123 渠道自定义参数 -- Channel Custom Parameter
adzone_id Number 必须 123 推广位ID，mm_xxx_xxx_12345678三段式的最后一段数字 -- Promotion position ID, the last segment of numbers in the three-part format mm_xxx_xxx_12345678.
url String 可选 https://item.taobao.com/item.htm?id=577542476710 淘宝详情页链接 -- Taobao product detail page link
platform Number 可选 1
  • 默认值：1
    		•  【废弃】链接形式：1：PC，2：无线，默认：1 -- [Deprecated] Link type: 1: PC, 2: Mobile, default: 1
    site String 可选 TW 站点标识：TW(台湾)；HK(香港)；MY(马来)；SG(新加坡)；AU(澳大利亚)；CA(加拿大)；MO(澳门)；GLOBAL(全球)，GLOBAL（全球）不存在禁限售的逻辑，若填写指定的站点，会校验禁限售的逻辑。 -- Site Identifier: TW (Taiwan); HK (Hong Kong); MY (Malaysia); SG (Singapore); AU (Australia); CA (Canada); MO (Macau); GLOBAL (Global). The "GLOBAL" identifier does not apply any restricted or prohibited sales logic. If a specific site is specified, the restricted/prohibited sales logic will be enforced.
    language String 可选 zh_CN
  • 默认值：zh_CN
    		•  语言：zh_CN(中文)；en_US(英文) -- Language: zh_CN (Chinese); en_US (English)

    响应参数

    名称 类型 示例值 描述
    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 默认跳转链接 – Default redirect link
    coupon_remain_count Number 6859 优惠券信息-券数量 – Coupon information - Number of coupons
    min_commission_rate String 20.3 商品信息-收入比率(%)；商品佣金比率+补贴比率 – Product information - Revenue ratio (%); Commission ratio + Subsidy ratio
    campaign_type Number 2 佣金类型。MKT表示营销计划，SP表示定向计划，COMMON表示通用计划，ZX表示自选计划 – Commission type. MKT represents Marketing Plan, SP represents Targeted Plan, COMMON represents General Plan, ZX represents Custom Plan
    coupon_info String 满16元减10元 优惠券信息-券文案 – Coupon information - Coupon description
    max_commission_rate String 20.3 商品信息-收入比率(%)；商品佣金比率+补贴比率 – Product information - Revenue ratio (%); Commission ratio + Subsidy ratio
    coupon_total_count Number 8000 优惠券信息-券有效时间-结束时间 – Coupon information - Coupon validity period - End time
    coupon_end_time String 2016-09-26 优惠券信息-券有效时间-结束时间 – Coupon information - Coupon validity period - End time
    item_id Number 524136796550 商品信息-淘宝客新商品ID – Product information - Taobao Partner new product ID
    coupon_type Number 1 【废弃】优惠券(商品优惠券推广链接中的券)类型，1 公开券，2 私有券，3 妈妈券 -- [Deprecated] Coupon type (the coupon in the product coupon promotion link): 1 Public coupon, 2 Private coupon, 3 Mama coupon
    coupon_start_time String 2016-09-25 优惠券信息-券有效时间-开始时间 – Coupon information - Coupon validity period - Start time
    category_id Number 1 后台一级类目ID -- Backend primary category ID

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    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);
    req.setSite("TW");
    req.setLanguage("zh_CN");
    OvsTbkItemConvertGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    <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示例
    1
    2
    3
    4
    5
    6
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    20001 系统执行错误 稍后重试
    600 参数不正确 检查请求参数是否正确
    isv.item-not-exist 返回商品物料结果为空 更换商品查询
    10101 返回商品物料结果为空 更换商品查询
    10004 参数不正确 请检查请求参数是否符合要求

    API工具

    API测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部