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

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

淘宝客商品三方分成链接转换

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adzone_id Number 必须 123 广告位ID,区分效果位置
fields String 必须 num_iid,click_url 需返回的字段列表
num_iids String 必须 123,456 商品ID串,用','分割,从taobao.tbk.item.get接口获取num_iid字段
platform Number 可选 1
  • 默认值:1
  • 链接形式:1:PC,2:无线,默认:1
    sub_pid String 必须 mm_123_123_123 三方pid,满足mm_xxx_xxx_xxx格式
    unid String 可选 demo 该字段不使用。
    dx String 可选 1 1表示商品转通用计划链接,其他值或不传表示优先转营销计划链接
    coupon_id String 可选 1 券id,券仅支持关联唯一一个商品,输入券id,请确保商品id也是唯一的

    响应参数

    名称 类型 示例值 描述
    results NTbkItem [] 淘宝客商品
    • └ click_url
    • String
    • http://s.click.taobao.com/e=xxx
    • 单品的淘客地址或有优惠券商品的淘客地址
    • └ num_iid
    • String
    • 123
    • 商品ID
    • └ commission_rate
    • String
    • 3.60
    • 当前转链计划的商品佣金率(%)
    • └ coupon_amount
    • String
    • 10.00
    • 优惠券面额,宝贝没有优惠券时,为空
    • └ coupon_click_url
    • String
    • https://uland.taobao.com/coupon/edetail?e=xxx
    • 优惠券地址,不论宝贝是否有优惠券,本地址均非空。调用者可参考coupon_amount的值以判断使用coupon_click_url或click_url。
    • └ added_time
    • Number
    • 1585929600000
    • 定时上架商品的上架时间。格式为时间戳,单位为毫秒。对于已上架商品,该字段为空,无意义。
    • └ item_status
    • Number
    • 1
    • 商品的商家状态。0表示已上架;1表示定时上架商品。
    • └ input_num_iid
    • String
    • 1
    • 原始输入的商品id

    请求示例

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

    响应示例

    • XML示例
    • JSON示例
    <tbk_item_share_convert_response>
        <results>
            <n_tbk_item>
                <click_url>http://s.click.taobao.com/e=xxx</click_url>
                <num_iid>123</num_iid>
                <commission_rate>3.60</commission_rate>
                <coupon_amount>10.00</coupon_amount>
                <coupon_click_url>https://uland.taobao.com/coupon/edetail?e=xxx</coupon_click_url>
                <added_time>1585929600000</added_time>
                <item_status>1</item_status>
                <input_num_iid>1</input_num_iid>
            </n_tbk_item>
        </results>
    </tbk_item_share_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:sub_pid sub_pid不正确 请填写正确的三方pid,满足mm_xxx_xxx_xxx格式
    isp.tbkapi-service-unavailable 内部服务不可用 稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部