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

taobao.tbk.dg.eshare.link.convert (淘宝客-推广者-KA私域专享转链)

淘宝客-推广者-KA私域专享转链

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adzone_id Number 可选 1234 推广位id,mm_xx_xx_xx pid三段式中的第三段
relation_id String 可选 1234 渠道管理ID
item_dto LkItemDTO 可选 商品转链
  • └ item_id
  • String
  • 可选
  • i87a9ja90d8-09qrjcoa7qwl
  • 商品id,用于标识具体商品
material_dto LkMaterialDTO 可选 链接/口令转链
  • └ material_url
  • String
  • 可选
  • s.click.taobao.com
  • 物料链接,可以为url或淘口令

响应参数

名称 类型 示例值 描述
data TbkLinkDTO TbkLinkDTO TbkLinkDTO
  • material_url_list
  • MaterialUrlList []
  • 转链结果
  • └ msg
  • String
  • 无权限
  • 物料对应错误描述
  • └ code
  • Number
  • 1001
  • 物料对应错误码
  • link_info_dto
  • LinkInfoDTO
  • 链接信息
  • └ coupon_long_url
  • String
  • https://uland.taobao.com/coupon/edetail?e=HcDWJQP6d12lhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWBzzpT26idJDtOYUTZvUxMupZB35fyH%2Bj%2BFrYU%2BROQkienhT0Gv%2FXXPpGXqwTrgn%2FiLFm3yG1xo9E3CIsWU5pj75f%2FX7e6X6TX2Dcu6%2BWPof99KHcV2dz2Q%2BPTkUmCMR1R8iWumasxPjXTWFYYVpFI4%2Baud2Kv%2BmghqozJdwyPlqXT8BNPyRO3CWm71evwboq2ugOoDIQE5avhnuz9l3tbd8BHHMx2peL6n7tssF5spfgu%2BKM%2Fbf9sE%2BdAb1JoOOghqozJdwyPlaVcuzWAzoR%2BEffiaBagqGwiV9Bh6z0Brrk5oEZwv0ZJMDQVG07AK7A%3D%3D&traceId=816a277916715178333831026bf6cf&relationId=123456&&union_lens=lensId:TAPI@1671517839@21055fa7_0b7f_1852e3a1f30_0417@01
  • 二合一长链接
  • └ coupon_short_url
  • String
  • https://s.click.taobao.com/DvHjOPu
  • 二合一短链
  • └ coupon_short_tpwd
  • String
  • ¥p7lYdesjTCG¥
  • 二合一链接的短口令
  • └ coupon_full_tpwd
  • String
  • 47¥ CZ3457 p7lYdesjTCG¥ https://m.tb.cn/h.UQ4ceEA 我的天呐麻酱爆肚粉香辣花甲粉重庆酸辣粉方便速食粉条六袋装
  • 二合一链接的长口令
  • └ material_type
  • Number
  • 1
  • 1—单品
  • └ tk_biz_type
  • Number
  • 2
  • 1-联盟口令,2-主站口令。入参物料不为淘口令时,此字段返回null
  • └ input_material_url
  • String
  • s.click.taobao.com
  • 入参物料链接
  • promotion_info_dto
  • MaterialPromotionInfoDTO
  • 营销信息
  • └ commission_rate
  • String
  • 6.00
  • 商品收入比率(%):商品佣金比率+补贴比率。同物料类接口income_rate
  • └ commission_type
  • String
  • MKT
  • 佣金类型。MKT表示营销计划,SP表示定向计划,COMMON表示通用计划,ZX表示自选计划
  • item_url_list
  • ItemUrlList []
  • 单品转链信息
  • └ msg
  • String
  • 无权限
  • 单品转链信息
  • └ code
  • Number
  • 1001
  • 物料对应错误码
  • link_info_dto
  • ItemLinkInfoDTO
  • 链接信息
  • └ coupon_long_url
  • String
  • https://uland.taobao.com/coupon/edetail?e=G6GuYx3ILfalhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWBzzpT26idJtx9C1Z8GbV1vHgx4K91Wrd9oW7c0CRLBdz881e47Ft9oBDRNgYIxgFNRd9B4OBPr9E3CIsWU5pj75f%2FX7e6X6TX2Dcu6%2BWPof99KHcV2dz2Q%2BPTkUmCMR1R8iWumasxPjXTWFYYVpFI4%2Baud2Kv%2BmrRMCeO3Mi1ouPODd%2FkGgeDCWm71evwboq2ugOoDIQE5avhnuz9l3tbd8BHHMx2peL6n7tssF5spfgu%2BKM%2Fbf9sE%2BdAb1JoOOrRMCeO3Mi1oDb9krsjLiJ069NSKr8HLD%2F5cBb8E%2Fg255M0kZg5qGOw%3D&traceId=816a277916715178333831026bf6cf&relationId=123456&&union_lens=lensId:TAPI@1671517838@21055fa7_0b7f_1852e3a1bae_0416@01
  • 二合一长链接
  • └ item_id
  • String
  • https://uland.taobao.com/coupon/edetail?e=G6GuYx3ILfalhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWBzzpT26idJtx9C1Z8GbV1vHgx4K91Wrd9oW7c0CRLBdz881e47Ft9oBDRNgYIxgFNRd9B4OBPr9E3CIsWU5pj75f%2FX7e6X6TX2Dcu6%2BWPof99KHcV2dz2Q%2BPTkUmCMR1R8iWumasxPjXTWFYYVpFI4%2Baud2Kv%2BmrRMCeO3Mi1ouPODd%2FkGgeDCWm71evwboq2ugOoDIQE5avhnuz9l3tbd8BHHMx2peL6n7tssF5spfgu%2BKM%2Fbf9sE%2BdAb1JoOOrRMCeO3Mi1oDb9krsjLiJ069NSKr8HLD%2F5cBb8E%2Fg255M0kZg5qGOw%3D&traceId=816a277916715178333831026bf6cf&relationId=123456&&union_lens=lensId:TAPI@1671517838@21055fa7_0b7f_1852e3a1bae_0416@01
  • 商品ID
  • └ material_type
  • Number
  • 1
  • 1—单品
  • └ coupon_short_url
  • String
  • https://s.click.taobao.com/HvHjOPu
  • 二合一短链
  • └ coupon_short_tpwd
  • String
  • ¥LOcqdeIlU9y¥
  • 二合一链接的短口令
  • └ coupon_full_tpwd
  • String
  • 48¥ CZ3457 LOcqdeIlU9y¥ https://m.tb.cn/h.UQ4ceEC olayks煮茶器喷淋式黑茶白茶煮茶壶家用自动蒸汽养生壶办公室小型
  • 二合一链接的长口令
  • └ input_item_id
  • String
  • i87a9ja90d8-09qrjcoa7qwl
  • 入参的商品ID
  • promotion_info_dto
  • ItemPromotionInfoDTO
  • 营销信息
  • └ commission_rate
  • String
  • 2.40
  • 商品收入比率(%):商品佣金比率+补贴比率。同物料类接口income_rate
  • └ commission_type
  • String
  • MKT
  • 佣金类型。MKT表示营销计划,SP表示定向计划,COMMON表示通用计划,ZX表示自选计划
biz_error_desc String 1 错误码描述
result_msg String 1 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgEshareLinkConvertRequest req = new TbkDgEshareLinkConvertRequest();
req.setAdzoneId(1234L);
req.setRelationId("1234");
TbkDgEshareLinkConvertRequest.LkItemDTO obj1 = new TbkDgEshareLinkConvertRequest.LkItemDTO();
obj1.setItemId("i87a9ja90d8-09qrjcoa7qwl");
req.setItemDto(obj1);
TbkDgEshareLinkConvertRequest.LkMaterialDTO obj2 = new TbkDgEshareLinkConvertRequest.LkMaterialDTO();
obj2.setMaterialUrl("s.click.taobao.com");
req.setMaterialDto(obj2);
TbkDgEshareLinkConvertResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_dg_eshare_link_convert_response>
    <data>
        <material_url_list>
            <material_url_list>
                <msg>无权限</msg>
                <code>1001</code>
                <link_info_dto>
                    <coupon_long_url>https://uland.taobao.com/coupon/edetail?e=HcDWJQP6d12lhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWBzzpT26idJDtOYUTZvUxMupZB35fyH%2Bj%2BFrYU%2BROQkienhT0Gv%2FXXPpGXqwTrgn%2FiLFm3yG1xo9E3CIsWU5pj75f%2FX7e6X6TX2Dcu6%2BWPof99KHcV2dz2Q%2BPTkUmCMR1R8iWumasxPjXTWFYYVpFI4%2Baud2Kv%2BmghqozJdwyPlqXT8BNPyRO3CWm71evwboq2ugOoDIQE5avhnuz9l3tbd8BHHMx2peL6n7tssF5spfgu%2BKM%2Fbf9sE%2BdAb1JoOOghqozJdwyPlaVcuzWAzoR%2BEffiaBagqGwiV9Bh6z0Brrk5oEZwv0ZJMDQVG07AK7A%3D%3D&amp;traceId=816a277916715178333831026bf6cf&amp;relationId=123456&amp;&amp;union_lens=lensId:TAPI@1671517839@21055fa7_0b7f_1852e3a1f30_0417@01</coupon_long_url>
                    <coupon_short_url>https://s.click.taobao.com/DvHjOPu</coupon_short_url>
                    <coupon_short_tpwd>¥p7lYdesjTCG¥</coupon_short_tpwd>
                    <coupon_full_tpwd>47¥ CZ3457 p7lYdesjTCG¥ https://m.tb.cn/h.UQ4ceEA  我的天呐麻酱爆肚粉香辣花甲粉重庆酸辣粉方便速食粉条六袋装</coupon_full_tpwd>
                    <material_type>1</material_type>
                    <tk_biz_type>2</tk_biz_type>
                </link_info_dto>
                <input_material_url>s.click.taobao.com</input_material_url>
                <promotion_info_dto>
                    <commission_rate>6.00</commission_rate>
                    <commission_type>MKT</commission_type>
                </promotion_info_dto>
            </material_url_list>
        </material_url_list>
        <item_url_list>
            <item_url_list>
                <msg>无权限</msg>
                <code>1001</code>
                <link_info_dto>
                    <coupon_long_url>https://uland.taobao.com/coupon/edetail?e=G6GuYx3ILfalhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWBzzpT26idJtx9C1Z8GbV1vHgx4K91Wrd9oW7c0CRLBdz881e47Ft9oBDRNgYIxgFNRd9B4OBPr9E3CIsWU5pj75f%2FX7e6X6TX2Dcu6%2BWPof99KHcV2dz2Q%2BPTkUmCMR1R8iWumasxPjXTWFYYVpFI4%2Baud2Kv%2BmrRMCeO3Mi1ouPODd%2FkGgeDCWm71evwboq2ugOoDIQE5avhnuz9l3tbd8BHHMx2peL6n7tssF5spfgu%2BKM%2Fbf9sE%2BdAb1JoOOrRMCeO3Mi1oDb9krsjLiJ069NSKr8HLD%2F5cBb8E%2Fg255M0kZg5qGOw%3D&amp;traceId=816a277916715178333831026bf6cf&amp;relationId=123456&amp;&amp;union_lens=lensId:TAPI@1671517838@21055fa7_0b7f_1852e3a1bae_0416@01</coupon_long_url>
                    <item_id>https://uland.taobao.com/coupon/edetail?e=G6GuYx3ILfalhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWBzzpT26idJtx9C1Z8GbV1vHgx4K91Wrd9oW7c0CRLBdz881e47Ft9oBDRNgYIxgFNRd9B4OBPr9E3CIsWU5pj75f%2FX7e6X6TX2Dcu6%2BWPof99KHcV2dz2Q%2BPTkUmCMR1R8iWumasxPjXTWFYYVpFI4%2Baud2Kv%2BmrRMCeO3Mi1ouPODd%2FkGgeDCWm71evwboq2ugOoDIQE5avhnuz9l3tbd8BHHMx2peL6n7tssF5spfgu%2BKM%2Fbf9sE%2BdAb1JoOOrRMCeO3Mi1oDb9krsjLiJ069NSKr8HLD%2F5cBb8E%2Fg255M0kZg5qGOw%3D&amp;traceId=816a277916715178333831026bf6cf&amp;relationId=123456&amp;&amp;union_lens=lensId:TAPI@1671517838@21055fa7_0b7f_1852e3a1bae_0416@01</item_id>
                    <material_type>1</material_type>
                    <coupon_short_url>https://s.click.taobao.com/HvHjOPu</coupon_short_url>
                    <coupon_short_tpwd>¥LOcqdeIlU9y¥</coupon_short_tpwd>
                    <coupon_full_tpwd>48¥ CZ3457 LOcqdeIlU9y¥ https://m.tb.cn/h.UQ4ceEC  olayks煮茶器喷淋式黑茶白茶煮茶壶家用自动蒸汽养生壶办公室小型</coupon_full_tpwd>
                </link_info_dto>
                <input_item_id>i87a9ja90d8-09qrjcoa7qwl</input_item_id>
                <promotion_info_dto>
                    <commission_rate>2.40</commission_rate>
                    <commission_type>MKT</commission_type>
                </promotion_info_dto>
            </item_url_list>
        </item_url_list>
    </data>
    <biz_error_desc>1</biz_error_desc>
    <result_msg>1</result_msg>
</tbk_dg_eshare_link_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

返回
顶部