文档中心 > API类目 > 淘宝客API

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

淘宝客商品链接转换

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adzone_id Number 必须 123 广告位ID,区分效果位置
fields String 必须 num_iid,click_url 需返回的字段列表
num_iids String 必须 123,456 商品ID串,用','分割,从taobao.tbk.item.get接口获取num_iid字段,最大40个
platform Number 可选 123
  • 默认值:1
  • 链接形式:1:PC,2:无线,默认:1
    unid String 可选 demo 自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道
    dx String 可选 1 1表示商品转通用计划链接,其他值或不传表示转营销计划链接

    响应参数

    名称 类型 示例值 描述
    results NTbkItem [] 淘宝客商品
    • └ click_url
    • String
    • http://s.click.taobao.com/e=xxx
    • 淘客地址
    • └ num_iid
    • String
    • 123
    • 商品ID
    • └ input_num_iid
    • String
    • 1
    • 原始输入的商品ID

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkItemConvertRequest req = new TbkItemConvertRequest();
    req.setAdzoneId(123L);
    req.setFields("num_iid,click_url");
    req.setNumIids("123,456");
    req.setPlatform(123L);
    req.setUnid("demo");
    req.setDx("1");
    TbkItemConvertResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tbk_item_convert_response>
        <results>
            <n_tbk_item>
                <click_url>http://s.click.taobao.com/e=xxx</click_url>
                <num_iid>123</num_iid>
                <input_num_iid>1</input_num_iid>
            </n_tbk_item>
        </results>
    </tbk_item_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:adzone_id adzone_id不正确 请填写与member_id和site_id匹配的adzone_id
    isv.invalid-parameter:platform platform不正确 请填写正确的platform
    isv.invalid-parameter:unid unid不正确 请填写正确的union id
    isp.tbkapi-service-unavailable 内部服务不可用 稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部