淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
biz_scene_id	String	可选	1	1-动态ID转链场景，2-消费者比价场景，4-
promotion_type	String	可选	2	1-自购省，2-推广赚（代理模式专属ID，代理模式必填，其它模式不用填写本字段）
material_list	String	可选	https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu	物料列表，可以为url或淘口令,多个时使用英文逗号拼接传入
relation_id	String	可选	123456	渠道管理ID（如是主站选品推广场景，必须入参该字段，且bizSceneId字段需入参2-消费者比价场景，否则二次转链失败）
adzone_id	Number	必须	123456	推广位id，mm_xx_xx_xx pid三段式中的第三段
seller_id_list	String	可选	123456	卖家ID列表,多个时使用英文逗号拼接传入
item_id_list	String	可选	qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9	商品ID列表,多个时使用英文逗号拼接传入
page_id_list	String	可选	123456	会场ID列表,多个时使用英文逗号拼接传入
target_item	TargetItemDTO	可选		会场页面内定坑商品
└ item_id_list String [] 可选 xxx 页面内定坑商品ID，用于素材-坑位还原
item_dto	LkItemDTO	可选		商品转链
└ item_id String 可选 i87a9ja90d8-09qrjcoa7qwl 商品ID └ sku_id Number 可选 123 入参商品id下的skuid，传入时会透传至转链结果url中 └ is_target_coupon Number 可选 1 是否指定券，1-指定 0-不指定默认为0（邀约制权限，仅面向KA淘宝客） └ coupon_id String 可选 9urytzd6k4 优惠券id（邀约制权限，仅面向KA淘宝客） └ external_id String 可选 123 淘宝客外部用户标记，如自身系统账户ID；微信ID等 └ dx String 可选 1 1表示商品转通用计划链接，其他值或不传表示转最优佣金率（含营销计划）链接
page_dto	LkItemDTO	可选		会场页面转链
└ page_id String 可选 20356789765 会场ID └ target_item_list String [] 可选 xxx 页面内定坑商品ID，用于素材-坑位还原
shop_dto	LkPageDTO	可选		店铺转链
└ shop_id String 可选 123456 店铺ID
material_dto	LkShopDTO	可选		链接/口令转链
└ material_url String 可选 s.click.taobao.com 物料链接，可以为url或淘口令 └ is_target_coupon Number 可选 1 是否指定券，1-指定 0-不指定默认为0（邀约制权限，仅面向KA淘宝客） └ coupon_id String 可选 9urytzd6k4 优惠券id（邀约制权限，仅面向KA淘宝客）
special_id	String	可选	123	会员运营id

名称	类型	示例值	描述
data	TbkLinkDTO	TbkLinkDTO	TbkLinkDTO
material_url_list MaterialUrlList [] 转链结果 └ msg String 无权限物料对应错误描述 └ code Number 1001 物料对应错误码 promotion_info_dto PromotionInfoDTO 营销信息 └ commission_rate String 6.00 商品收入比率(%)：商品佣金比率+补贴比率。同物料类接口income_rate └ commission_type String MKT 佣金类型。MKT表示营销计划，SP表示定向计划，COMMON表示通用计划，ZX表示自选计划 coupon_info_dto CouponInfoDTO 券信息 └ coupon_end_time String 2022-12-20 23:59:59 优惠券结束时间 └ activity_id String 19d114f1a6464c98a30b01b3cb17dad6 券ID └ coupon_remain_count Number 99944 优惠券剩余数量 └ coupon_amount String 80.00 券面额 └ coupon_start_time String 2022-12-14 00:00:00 优惠券开始时间 └ coupon_desc String 满129元减80元优惠券信息，满XX元减XX元 └ coupon_type Number 0 0-店铺 1-单品 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 二合一长链接 └ material_type Number 1 1—单品 2—店铺 3—会场 4-承接开放 5-优惠券 └ tpwd_origin_url String https://item.taobao.com/item.htm?ut_sk=1.XhmNDzLwwioDABH4T6RBuvTP_21380790_1671501684367.Copy.1&id=688401422805&sourceType=item&price=54.9-74.9&origin_price=99.9&suid=2E8B3B3D-EA1D-44E4-A8DA-AB3468C239D4&shareUniqueId=19373158797&un=5b73a79de2da8c8a6eabd07a58355624&share_crt_v=1&un_site=0&spm=a2159r.13376460.0.0&sp_abtk=gray_1_code_simpleios2&tbSocialPopKey=shareItem&sp_tk=RHozeWRlRk1TUk8%3D&bxsign=tcdmT6tdiAhdgQRocCDz2_2umO9B1ffOtxAo1He-EbLu6Z8E9uqjMKg6YM4XMDSmvrZ0JD_pREyShNr0YBO6s6oaUJCq7Vtcx-iOO7WBaqbUy4&bc_fl_src=share-522958211663-1-0 淘口令原始链接，入参物料不为淘口令时，此字段返回null └ material_id String 688401422805 物料ID，需根据material_type判断物料类型，可能为商品ID、卖家ID、会场ID └ cps_long_url String https://s.click.taobao.com/t?e=m%3D2%26s%3DKkbloP8JSAVw4vFB6t2Z2ueEDrYVVa64yK8Cckff7TVRAdhuF14FMU3VlJUC3DsQ79%2FTFaMDK6Qc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQEVUjoeWqzb%2BCGsxm48e9hkfF%2Bxu0N%2BwWs0Rgp8gMc9dY1tyQTTDSHqySbHmSI7wOtef%2FroYqRldzn0lFpzXFujTCQ%2BHTk5EfzW8%2BBPSvjFWUZSZEfZ0FH4Va78Lza%2BD%2Fuqo6mSuTG7PlEs8HjV3hrkr1j%2BhoHy6%2FQNdzcFFug%2BbPXd6fR%2Fgq%2FLkcuZKrbdCBTlriuf8gGMP3mPUmtHv0Nb2kE%2BTfvdp4q7CEA%2B11P8YwWLI0fvJc3aqk5eKOUwbKCMNd%2Byi53bExg5p7bh%2BFbQ%3D&union_lens=lensId:TAPI@1671517839@21055fa7_0b7f_1852e3a1f30_0417@01 CPS链接长链 └ cps_short_tpwd String ￥zRmVdesjTCu￥ CPS链接的短口令 └ tk_biz_type Number 2 1-联盟口令，2-主站口令。入参物料不为淘口令时，此字段返回null └ coupon_short_tpwd String ￥p7lYdesjTCG￥二合一链接的短口令 └ cps_short_url String https://s.click.taobao.com/CvHjOPu CPS链接短链 └ coupon_short_url String https://s.click.taobao.com/DvHjOPu 二合一链接长链 └ coupon_full_tpwd String 47￥ CZ3457 p7lYdesjTCG￥ https://m.tb.cn/h.UQ4ceEA 我的天呐麻酱爆肚粉香辣花甲粉重庆酸辣粉方便速食粉条六袋装二合一链接的长口令 └ cps_full_tpwd String 39￥ CZ3457 zRmVdesjTCu￥ https://m.tb.cn/h.UQ4cewa 我的天呐麻酱爆肚粉香辣花甲粉重庆酸辣粉方便速食粉条六袋装 CPS链接的长口令 └ input_material_url String s.click.taobao.com 入参物料链接 └ extra_info String skuid已失效转链成功的场景下，需要补充说明的信息 shop_url_list ShopUrlList [] 店铺转链结果 └ msg String 无权限物料对应错误描述 └ code Number 1001 物料对应错误码 link_info_dto LinkInfoDTO 链接信息 └ material_type Number 2 1—单品 2—店铺 3—会场 └ seller_id String 123456 卖家ID └ cps_long_url String https://s.click.taobao.com/t?e=m%3D2%26s%3DYryVaqQlYtxw4vFB6t2Z2jAVflQIoZepyK8Cckff7TVRAdhuF14FMU3VlJUC3DsQMMgx22UI05Yc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQJFcOCF3%2FDbwRh53k%2Fssh4t44u6hki9mkh%2BLdPuJoV%2FRzl3tHIK2mthnPjZ5WWqolAEgO5kclpNKBjInADNbJYxEcfNLn7HIXszVe3Fb2x4s%2FJDmTntQaQzGDmntuH4VtA%3D%3D 店铺CPS长链接 └ cps_short_tpwd String ￥EAqldesjTCt￥店铺CPS链接对应短口令 └ cps_short_url String https://s.click.taobao.com/FvHjOPu 店铺CPS短链 └ cps_full_tpwd String 58￥ CZ3457 EAqldesjTCt￥ https://m.tb.cn/h.UQ4ceEB 韩都衣舍旗舰店店铺CPS链接对应长口令 └ input_shop_id String 123 入参的店铺ID event_url_list EventUrlList [] 活动转链信息 └ msg String 无权限物料对应错误描述 └ code Number 1001 物料对应错误码 link_info_dto LinkInfoDTO 链接信息 └ material_type Number 3 1—单品 2—店铺 3—会场 └ page_id String 20150318020014311 会场ID └ cps_long_url String https://s.click.taobao.com/t?union_lens=lensId%3AOPT%401671517838%402107457f_128d_1852e3a1e2c_03f5%4001%3BeventPageId%3A20150318020014311&e=m%3D2%26s%3DKQjjrM92%2F7Nw4vFB6t2Z2iperVdZeJviU%2F9%2F0taeK29yINtkUhsv0Dl8FS4ucHenj2w9k21YZ3qgpaE1qudUv106NgiXS75NWi4GdVwNf8BfXAlTvwP7PvyclHulJsGMQ%2BNeRhkrKyfCg%2Fx6BHtN2amAOqUjIVeCy0DxCSzwFgFd1le1%2FF%2FLHa44ut0dMc8VMSJUXveljqoq%2FKh6EC%2FmGEM6gfQ3Aokl5MRYl0%2FyOZHb9no%2FURc5w7o18kPD%2BYRAFveQ9Ld2jorKLJiYzWv6xmKche5LvsSo37%2FLmqNFMyVzwS6VTp1JIFY8eNWMEbfNhDTn1psj9iZsDvbh8Qt7h8A2xIPV%2FpBCPqKNE1%2B%2FpYNizQgXEDae2m%2FrHB9aiVckS6fqAUnbbCiWZ1rWjVK6iMgmy2CsK7djvdOCkVnjXedCpzLnRBhrs1VdGRk68r9XJprbVzmT5j1Xj8w0BzyaviGFCzYOOqAQ 会场CPS长链接 └ cps_short_tpwd String ￥PnIodeIlU9z￥会场CPS链接的短口令 └ cps_short_url String https://s.click.taobao.com/EvHjOPu 会场CPS短链接 └ cps_full_tpwd String 37￥ CZ3457 PnIodeIlU9z￥ https://m.tb.cn/h.UQ4ceEz 22年天猫双旦礼遇季-主会场会场CPS链接的长口令 └ input_page_id String 203567898765 入参的会场ID item_url_list ItemUrlList [] 单品转链信息 └ msg String 无权限物料对应错误描述 └ code Number 1001 物料对应错误码 promotion_info_dto PromotionInfoDTO 营销信息 └ commission_rate String 2.40 商品收入比率(%)：商品佣金比率+补贴比率。同物料类接口income_rate └ commission_type String MKT 佣金类型。MKT表示营销计划，SP表示定向计划，COMMON表示通用计划，ZX表示自选计划 coupon_info_dto CouponInfoDTO 券信息 └ coupon_end_time String 2022-12-25 23:59:59 优惠券结束时间 └ activity_id String 642208f7db6b4fb9880a9d09832d6b8d 券ID └ coupon_remain_count Number 99987 优惠券剩余数量 └ coupon_amount String 170.00 券面额 └ coupon_start_time String 2022-12-20 00:00:00 优惠券开始时间 └ coupon_desc String 满319元减170元优惠券信息，满XX元减XX元 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 二合一长链接 └ material_type Number 1 1—单品 2—店铺 3—会场 └ item_id String y387e49cRt262Ozub0TvtA-dAeOMBinqPdm6Wxu0 商品ID └ cps_long_url String https://s.click.taobao.com/t?e=m%3D2%26s%3DvazOG0sd5LJw4vFB6t2Z2ueEDrYVVa64yK8Cckff7TVRAdhuF14FMU3VlJUC3DsQMMgx22UI05Yc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQEVUjoeWqzb%2BCGsxm48e9hkfF%2Bxu0N%2BwWrcZhRlC%2FudiDepej5CXPoiMHuv7RoNv0Q0jFsbsQ7KW1Te9msJWkXsmFF9fm0wobpd0%2BQldqeoBF76lcPm%2FucppnJfkRUzuToD2uOlbI2qURHUT0gmVRp7ZGL0GbiMMd6BniEC%2BBYvRVSjzVV%2FKpYdMm7k2GPZX7L96ZdZH32PNybxY5kax0%2FETNqkNLIJLJkR1E9IJlUaerji63R0xzxUxIlRe96WOqlr6NugmfTu3&union_lens=lensId:TAPI@1671517838@21055fa7_0b7f_1852e3a1bae_0416@01 CPS链接长链 └ cps_short_tpwd String ￥XODHdeIlU9B￥ CPS链接的短口令 └ coupon_short_tpwd String ￥LOcqdeIlU9y￥二合一链接的短口令 └ cps_short_url String https://s.click.taobao.com/GvHjOPu CPS链接短链 └ coupon_short_url String https://s.click.taobao.com/HvHjOPu 二合一链接长链 └ coupon_full_tpwd String 48￥ CZ3457 LOcqdeIlU9y￥ https://m.tb.cn/h.UQ4ceEC olayks煮茶器喷淋式黑茶白茶煮茶壶家用自动蒸汽养生壶办公室小型二合一链接的长口令 └ cps_full_tpwd String 47￥ CZ3457 XODHdeIlU9B￥ https://m.tb.cn/h.UQ4ceEy olayks煮茶器喷淋式黑茶白茶煮茶壶家用自动蒸汽养生壶办公室小型 CPS链接的长口令 └ input_item_id String i87a9ja90d8-09qrjcoa7qwl 入参的商品ID └ extra_info String skuid已失效转链成功的场景下，需要补充说明的信息
biz_error_desc	Number	1	见错误码描述
result_msg	String	1	见错误码描述

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgGeneralLinkConvertRequest req = new TbkDgGeneralLinkConvertRequest();
req.setBizSceneId("1");
req.setPromotionType("2");
req.setMaterialList("https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu");
req.setRelationId("123456");
req.setAdzoneId(123456L);
req.setSellerIdList("123456");
req.setItemIdList("qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9");
req.setPageIdList("123456");
TbkDgGeneralLinkConvertRequest.TargetItemDTO obj1 = new TbkDgGeneralLinkConvertRequest.TargetItemDTO();
obj1.setItemIdList("xxx");
req.setTargetItem(obj1);
TbkDgGeneralLinkConvertRequest.LkItemDTO obj2 = new TbkDgGeneralLinkConvertRequest.LkItemDTO();
obj2.setItemId("i87a9ja90d8-09qrjcoa7qwl");
obj2.setSkuId(123L);
obj2.setIsTargetCoupon(1L);
obj2.setCouponId("9urytzd6k4");
obj2.setExternalId("123");
obj2.setDx("1");
req.setItemDto(obj2);
TbkDgGeneralLinkConvertRequest.LkItemDTO obj3 = new TbkDgGeneralLinkConvertRequest.LkItemDTO();
obj3.setPageId("20356789765");
obj3.setTargetItemList("xxx");
req.setPageDto(obj3);
TbkDgGeneralLinkConvertRequest.LkPageDTO obj4 = new TbkDgGeneralLinkConvertRequest.LkPageDTO();
obj4.setShopId("123456");
req.setShopDto(obj4);
TbkDgGeneralLinkConvertRequest.LkShopDTO obj5 = new TbkDgGeneralLinkConvertRequest.LkShopDTO();
obj5.setMaterialUrl("s.click.taobao.com");
obj5.setIsTargetCoupon(1L);
obj5.setCouponId("9urytzd6k4");
req.setMaterialDto(obj5);
req.setSpecialId("123");
TbkDgGeneralLinkConvertResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TbkDgGeneralLinkConvertRequest req = new TbkDgGeneralLinkConvertRequest();
req.BizSceneId = "1";
req.PromotionType = "2";
req.MaterialList = "https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu";
req.RelationId = "123456";
req.AdzoneId = 123456L;
req.SellerIdList = "123456";
req.ItemIdList = "qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9";
req.PageIdList = "123456";
TbkDgGeneralLinkConvertRequest.TargetItemDTODomain obj1 = new TbkDgGeneralLinkConvertRequest.TargetItemDTODomain();
obj1.ItemIdList = "xxx";
req.TargetItem_ = obj1;
TbkDgGeneralLinkConvertRequest.LkItemDTODomain obj2 = new TbkDgGeneralLinkConvertRequest.LkItemDTODomain();
obj2.ItemId = "i87a9ja90d8-09qrjcoa7qwl";
obj2.SkuId = 123L;
obj2.IsTargetCoupon = 1L;
obj2.CouponId = "9urytzd6k4";
obj2.ExternalId = "123";
obj2.Dx = "1";
req.ItemDto_ = obj2;
TbkDgGeneralLinkConvertRequest.LkItemDTODomain obj3 = new TbkDgGeneralLinkConvertRequest.LkItemDTODomain();
obj3.PageId = "20356789765";
obj3.TargetItemList = "xxx";
req.PageDto_ = obj3;
TbkDgGeneralLinkConvertRequest.LkPageDTODomain obj4 = new TbkDgGeneralLinkConvertRequest.LkPageDTODomain();
obj4.ShopId = "123456";
req.ShopDto_ = obj4;
TbkDgGeneralLinkConvertRequest.LkShopDTODomain obj5 = new TbkDgGeneralLinkConvertRequest.LkShopDTODomain();
obj5.MaterialUrl = "s.click.taobao.com";
obj5.IsTargetCoupon = 1L;
obj5.CouponId = "9urytzd6k4";
req.MaterialDto_ = obj5;
req.SpecialId = "123";
TbkDgGeneralLinkConvertResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TbkDgGeneralLinkConvertRequest;
$req->setBizSceneId("1");
$req->setPromotionType("2");
$req->setMaterialList("https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu");
$req->setRelationId("123456");
$req->setAdzoneId("123456");
$req->setSellerIdList("123456");
$req->setItemIdList("qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9");
$req->setPageIdList("123456");
$target_item = new TargetItemDTO;
$target_item->item_id_list="xxx";
$req->setTargetItem(json_encode($target_item));
$item_dto = new LkItemDTO;
$item_dto->item_id="i87a9ja90d8-09qrjcoa7qwl";
$item_dto->sku_id="123";
$item_dto->is_target_coupon="1";
$item_dto->coupon_id="9urytzd6k4";
$item_dto->external_id="123";
$item_dto->dx="1";
$req->setItemDto(json_encode($item_dto));
$page_dto = new LkItemDTO;
$page_dto->page_id="20356789765";
$page_dto->target_item_list="xxx";
$req->setPageDto(json_encode($page_dto));
$shop_dto = new LkPageDTO;
$shop_dto->shop_id="123456";
$req->setShopDto(json_encode($shop_dto));
$material_dto = new LkShopDTO;
$material_dto->material_url="s.click.taobao.com";
$material_dto->is_target_coupon="1";
$material_dto->coupon_id="9urytzd6k4";
$req->setMaterialDto(json_encode($material_dto));
$req->setSpecialId("123");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.tbk.dg.general.link.convert' \
-d 'partner_id=apidoc' \
-d 'sign=52DD002329235C424A90C9A231B9F05B' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-05-08+05%3A38%3A25' \
-d 'v=2.0' \
-d 'adzone_id=123456' \
-d 'biz_scene_id=1' \
-d 'item_dto=item_dto' \
-d 'item_id_list=qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9' \
-d 'material_dto=material_dto' \
-d 'material_list=https%3A%2F%2Fs.click.taobao.com%2FpQBDhNu%2Chttps%3A%2F%2Fs.click.taobao.com%2FpQBDhNu' \
-d 'page_dto=page_dto' \
-d 'page_id_list=123456' \
-d 'promotion_type=2' \
-d 'relation_id=123456' \
-d 'seller_id_list=123456' \
-d 'shop_dto=shop_dto' \
-d 'special_id=123' \
-d 'target_item=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TbkDgGeneralLinkConvertRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.biz_scene_id="1"
req.promotion_type="2"
req.material_list="https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu"
req.relation_id="123456"
req.adzone_id=123456
req.seller_id_list="123456"
req.item_id_list="qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9"
req.page_id_list="123456"
req.target_item="数据结构示例JSON格式"
req.item_dto="item_dto"
req.page_dto="page_dto"
req.shop_dto="shop_dto"
req.material_dto="material_dto"
req.special_id="123"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.tbk.dg.general.link.convert");
add_param(pRequest,"biz_scene_id","1");
add_param(pRequest,"promotion_type","2");
add_param(pRequest,"material_list","https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu");
add_param(pRequest,"relation_id","123456");
add_param(pRequest,"adzone_id","123456");
add_param(pRequest,"seller_id_list","123456");
add_param(pRequest,"item_id_list","qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9");
add_param(pRequest,"page_id_list","123456");
add_param(pRequest,"target_item","数据结构JSON示例");
add_param(pRequest,"item_dto","数据结构JSON示例");
add_param(pRequest,"page_dto","数据结构JSON示例");
add_param(pRequest,"shop_dto","数据结构JSON示例");
add_param(pRequest,"material_dto","数据结构JSON示例");
add_param(pRequest,"special_id","123");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.tbk.dg.general.link.convert', {
	'biz_scene_id':'1',
	'promotion_type':'2',
	'material_list':'https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu',
	'relation_id':'123456',
	'adzone_id':'123456',
	'seller_id_list':'123456',
	'item_id_list':'qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9',
	'page_id_list':'123456',
	'target_item':'数据结构JSON示例',
	'item_dto':'数据结构JSON示例',
	'page_dto':'数据结构JSON示例',
	'shop_dto':'数据结构JSON示例',
	'material_dto':'数据结构JSON示例',
	'special_id':'123'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tbk_dg_general_link_convert_response>
    <data>
        <material_url_list>
            <material_url_list>
                <msg>无权限</msg>
                <code>1001</code>
                <promotion_info_dto>
                    <commission_rate>6.00</commission_rate>
                    <commission_type>MKT</commission_type>
                </promotion_info_dto>
                <coupon_info_dto>
                    <coupon_end_time>2022-12-20 23:59:59</coupon_end_time>
                    <activity_id>19d114f1a6464c98a30b01b3cb17dad6</activity_id>
                    <coupon_remain_count>99944</coupon_remain_count>
                    <coupon_amount>80.00</coupon_amount>
                    <coupon_start_time>2022-12-14 00:00:00</coupon_start_time>
                    <coupon_desc>满129元减80元</coupon_desc>
                    <coupon_type>0</coupon_type>
                </coupon_info_dto>
                <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>
                    <material_type>1</material_type>
                    <tpwd_origin_url>https://item.taobao.com/item.htm?ut_sk=1.XhmNDzLwwioDABH4T6RBuvTP_21380790_1671501684367.Copy.1&amp;id=688401422805&amp;sourceType=item&amp;price=54.9-74.9&amp;origin_price=99.9&amp;suid=2E8B3B3D-EA1D-44E4-A8DA-AB3468C239D4&amp;shareUniqueId=19373158797&amp;un=5b73a79de2da8c8a6eabd07a58355624&amp;share_crt_v=1&amp;un_site=0&amp;spm=a2159r.13376460.0.0&amp;sp_abtk=gray_1_code_simpleios2&amp;tbSocialPopKey=shareItem&amp;sp_tk=RHozeWRlRk1TUk8%3D&amp;bxsign=tcdmT6tdiAhdgQRocCDz2_2umO9B1ffOtxAo1He-EbLu6Z8E9uqjMKg6YM4XMDSmvrZ0JD_pREyShNr0YBO6s6oaUJCq7Vtcx-iOO7WBaqbUy4&amp;bc_fl_src=share-522958211663-1-0</tpwd_origin_url>
                    <material_id>688401422805</material_id>
                    <cps_long_url>https://s.click.taobao.com/t?e=m%3D2%26s%3DKkbloP8JSAVw4vFB6t2Z2ueEDrYVVa64yK8Cckff7TVRAdhuF14FMU3VlJUC3DsQ79%2FTFaMDK6Qc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQEVUjoeWqzb%2BCGsxm48e9hkfF%2Bxu0N%2BwWs0Rgp8gMc9dY1tyQTTDSHqySbHmSI7wOtef%2FroYqRldzn0lFpzXFujTCQ%2BHTk5EfzW8%2BBPSvjFWUZSZEfZ0FH4Va78Lza%2BD%2Fuqo6mSuTG7PlEs8HjV3hrkr1j%2BhoHy6%2FQNdzcFFug%2BbPXd6fR%2Fgq%2FLkcuZKrbdCBTlriuf8gGMP3mPUmtHv0Nb2kE%2BTfvdp4q7CEA%2B11P8YwWLI0fvJc3aqk5eKOUwbKCMNd%2Byi53bExg5p7bh%2BFbQ%3D&amp;union_lens=lensId:TAPI@1671517839@21055fa7_0b7f_1852e3a1f30_0417@01</cps_long_url>
                    <cps_short_tpwd>￥zRmVdesjTCu￥</cps_short_tpwd>
                    <tk_biz_type>2</tk_biz_type>
                    <coupon_short_tpwd>￥p7lYdesjTCG￥</coupon_short_tpwd>
                    <cps_short_url>https://s.click.taobao.com/CvHjOPu</cps_short_url>
                    <coupon_short_url>https://s.click.taobao.com/DvHjOPu</coupon_short_url>
                    <coupon_full_tpwd>47￥ CZ3457 p7lYdesjTCG￥ https://m.tb.cn/h.UQ4ceEA  我的天呐麻酱爆肚粉香辣花甲粉重庆酸辣粉方便速食粉条六袋装</coupon_full_tpwd>
                    <cps_full_tpwd>39￥ CZ3457 zRmVdesjTCu￥ https://m.tb.cn/h.UQ4cewa  我的天呐麻酱爆肚粉香辣花甲粉重庆酸辣粉方便速食粉条六袋装</cps_full_tpwd>
                </link_info_dto>
                <input_material_url>s.click.taobao.com</input_material_url>
                <extra_info>skuid已失效</extra_info>
            </material_url_list>
        </material_url_list>
        <shop_url_list>
            <shop_url_list>
                <msg>无权限</msg>
                <code>1001</code>
                <link_info_dto>
                    <material_type>2</material_type>
                    <seller_id>123456</seller_id>
                    <cps_long_url>https://s.click.taobao.com/t?e=m%3D2%26s%3DYryVaqQlYtxw4vFB6t2Z2jAVflQIoZepyK8Cckff7TVRAdhuF14FMU3VlJUC3DsQMMgx22UI05Yc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQJFcOCF3%2FDbwRh53k%2Fssh4t44u6hki9mkh%2BLdPuJoV%2FRzl3tHIK2mthnPjZ5WWqolAEgO5kclpNKBjInADNbJYxEcfNLn7HIXszVe3Fb2x4s%2FJDmTntQaQzGDmntuH4VtA%3D%3D</cps_long_url>
                    <cps_short_tpwd>￥EAqldesjTCt￥</cps_short_tpwd>
                    <cps_short_url>https://s.click.taobao.com/FvHjOPu</cps_short_url>
                    <cps_full_tpwd>58￥ CZ3457 EAqldesjTCt￥ https://m.tb.cn/h.UQ4ceEB  韩都衣舍旗舰店</cps_full_tpwd>
                </link_info_dto>
                <input_shop_id>123</input_shop_id>
            </shop_url_list>
        </shop_url_list>
        <event_url_list>
            <event_url_list>
                <msg>无权限</msg>
                <code>1001</code>
                <link_info_dto>
                    <material_type>3</material_type>
                    <page_id>20150318020014311</page_id>
                    <cps_long_url>https://s.click.taobao.com/t?union_lens=lensId%3AOPT%401671517838%402107457f_128d_1852e3a1e2c_03f5%4001%3BeventPageId%3A20150318020014311&amp;e=m%3D2%26s%3DKQjjrM92%2F7Nw4vFB6t2Z2iperVdZeJviU%2F9%2F0taeK29yINtkUhsv0Dl8FS4ucHenj2w9k21YZ3qgpaE1qudUv106NgiXS75NWi4GdVwNf8BfXAlTvwP7PvyclHulJsGMQ%2BNeRhkrKyfCg%2Fx6BHtN2amAOqUjIVeCy0DxCSzwFgFd1le1%2FF%2FLHa44ut0dMc8VMSJUXveljqoq%2FKh6EC%2FmGEM6gfQ3Aokl5MRYl0%2FyOZHb9no%2FURc5w7o18kPD%2BYRAFveQ9Ld2jorKLJiYzWv6xmKche5LvsSo37%2FLmqNFMyVzwS6VTp1JIFY8eNWMEbfNhDTn1psj9iZsDvbh8Qt7h8A2xIPV%2FpBCPqKNE1%2B%2FpYNizQgXEDae2m%2FrHB9aiVckS6fqAUnbbCiWZ1rWjVK6iMgmy2CsK7djvdOCkVnjXedCpzLnRBhrs1VdGRk68r9XJprbVzmT5j1Xj8w0BzyaviGFCzYOOqAQ</cps_long_url>
                    <cps_short_tpwd>￥PnIodeIlU9z￥</cps_short_tpwd>
                    <cps_short_url>https://s.click.taobao.com/EvHjOPu</cps_short_url>
                    <cps_full_tpwd>37￥ CZ3457 PnIodeIlU9z￥ https://m.tb.cn/h.UQ4ceEz  22年天猫双旦礼遇季-主会场</cps_full_tpwd>
                </link_info_dto>
                <input_page_id>203567898765</input_page_id>
            </event_url_list>
        </event_url_list>
        <item_url_list>
            <item_url_list>
                <msg>无权限</msg>
                <code>1001</code>
                <promotion_info_dto>
                    <commission_rate>2.40</commission_rate>
                    <commission_type>MKT</commission_type>
                </promotion_info_dto>
                <coupon_info_dto>
                    <coupon_end_time>2022-12-25 23:59:59</coupon_end_time>
                    <activity_id>642208f7db6b4fb9880a9d09832d6b8d</activity_id>
                    <coupon_remain_count>99987</coupon_remain_count>
                    <coupon_amount>170.00</coupon_amount>
                    <coupon_start_time>2022-12-20 00:00:00</coupon_start_time>
                    <coupon_desc>满319元减170元</coupon_desc>
                </coupon_info_dto>
                <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>
                    <material_type>1</material_type>
                    <item_id>y387e49cRt262Ozub0TvtA-dAeOMBinqPdm6Wxu0</item_id>
                    <cps_long_url>https://s.click.taobao.com/t?e=m%3D2%26s%3DvazOG0sd5LJw4vFB6t2Z2ueEDrYVVa64yK8Cckff7TVRAdhuF14FMU3VlJUC3DsQMMgx22UI05Yc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQEVUjoeWqzb%2BCGsxm48e9hkfF%2Bxu0N%2BwWrcZhRlC%2FudiDepej5CXPoiMHuv7RoNv0Q0jFsbsQ7KW1Te9msJWkXsmFF9fm0wobpd0%2BQldqeoBF76lcPm%2FucppnJfkRUzuToD2uOlbI2qURHUT0gmVRp7ZGL0GbiMMd6BniEC%2BBYvRVSjzVV%2FKpYdMm7k2GPZX7L96ZdZH32PNybxY5kax0%2FETNqkNLIJLJkR1E9IJlUaerji63R0xzxUxIlRe96WOqlr6NugmfTu3&amp;union_lens=lensId:TAPI@1671517838@21055fa7_0b7f_1852e3a1bae_0416@01</cps_long_url>
                    <cps_short_tpwd>￥XODHdeIlU9B￥</cps_short_tpwd>
                    <coupon_short_tpwd>￥LOcqdeIlU9y￥</coupon_short_tpwd>
                    <cps_short_url>https://s.click.taobao.com/GvHjOPu</cps_short_url>
                    <coupon_short_url>https://s.click.taobao.com/HvHjOPu</coupon_short_url>
                    <coupon_full_tpwd>48￥ CZ3457 LOcqdeIlU9y￥ https://m.tb.cn/h.UQ4ceEC  olayks煮茶器喷淋式黑茶白茶煮茶壶家用自动蒸汽养生壶办公室小型</coupon_full_tpwd>
                    <cps_full_tpwd>47￥ CZ3457 XODHdeIlU9B￥ https://m.tb.cn/h.UQ4ceEy  olayks煮茶器喷淋式黑茶白茶煮茶壶家用自动蒸汽养生壶办公室小型</cps_full_tpwd>
                </link_info_dto>
                <input_item_id>i87a9ja90d8-09qrjcoa7qwl</input_item_id>
                <extra_info>skuid已失效</extra_info>
            </item_url_list>
        </item_url_list>
    </data>
    <biz_error_desc>1</biz_error_desc>
    <result_msg>1</result_msg>
</tbk_dg_general_link_convert_response>

{
    "tbk_dg_general_link_convert_response":{
        "data":{
            "material_url_list":{
                "material_url_list":[
                    {
                        "msg":"无权限",
                        "code":1001,
                        "promotion_info_dto":{
                            "commission_rate":"6.00",
                            "commission_type":"MKT"
                        },
                        "coupon_info_dto":{
                            "coupon_end_time":"2022-12-20 23:59:59",
                            "activity_id":"19d114f1a6464c98a30b01b3cb17dad6",
                            "coupon_remain_count":99944,
                            "coupon_amount":"80.00",
                            "coupon_start_time":"2022-12-14 00:00:00",
                            "coupon_desc":"满129元减80元",
                            "coupon_type":0
                        },
                        "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&traceId=816a277916715178333831026bf6cf&relationId=123456&&union_lens=lensId:TAPI@1671517839@21055fa7_0b7f_1852e3a1f30_0417@01",
                            "material_type":1,
                            "tpwd_origin_url":"https:\/\/item.taobao.com\/item.htm?ut_sk=1.XhmNDzLwwioDABH4T6RBuvTP_21380790_1671501684367.Copy.1&id=688401422805&sourceType=item&price=54.9-74.9&origin_price=99.9&suid=2E8B3B3D-EA1D-44E4-A8DA-AB3468C239D4&shareUniqueId=19373158797&un=5b73a79de2da8c8a6eabd07a58355624&share_crt_v=1&un_site=0&spm=a2159r.13376460.0.0&sp_abtk=gray_1_code_simpleios2&tbSocialPopKey=shareItem&sp_tk=RHozeWRlRk1TUk8%3D&bxsign=tcdmT6tdiAhdgQRocCDz2_2umO9B1ffOtxAo1He-EbLu6Z8E9uqjMKg6YM4XMDSmvrZ0JD_pREyShNr0YBO6s6oaUJCq7Vtcx-iOO7WBaqbUy4&bc_fl_src=share-522958211663-1-0",
                            "material_id":"688401422805",
                            "cps_long_url":"https:\/\/s.click.taobao.com\/t?e=m%3D2%26s%3DKkbloP8JSAVw4vFB6t2Z2ueEDrYVVa64yK8Cckff7TVRAdhuF14FMU3VlJUC3DsQ79%2FTFaMDK6Qc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQEVUjoeWqzb%2BCGsxm48e9hkfF%2Bxu0N%2BwWs0Rgp8gMc9dY1tyQTTDSHqySbHmSI7wOtef%2FroYqRldzn0lFpzXFujTCQ%2BHTk5EfzW8%2BBPSvjFWUZSZEfZ0FH4Va78Lza%2BD%2Fuqo6mSuTG7PlEs8HjV3hrkr1j%2BhoHy6%2FQNdzcFFug%2BbPXd6fR%2Fgq%2FLkcuZKrbdCBTlriuf8gGMP3mPUmtHv0Nb2kE%2BTfvdp4q7CEA%2B11P8YwWLI0fvJc3aqk5eKOUwbKCMNd%2Byi53bExg5p7bh%2BFbQ%3D&union_lens=lensId:TAPI@1671517839@21055fa7_0b7f_1852e3a1f30_0417@01",
                            "cps_short_tpwd":"￥zRmVdesjTCu￥",
                            "tk_biz_type":2,
                            "coupon_short_tpwd":"￥p7lYdesjTCG￥",
                            "cps_short_url":"https:\/\/s.click.taobao.com\/CvHjOPu",
                            "coupon_short_url":"https:\/\/s.click.taobao.com\/DvHjOPu",
                            "coupon_full_tpwd":"47￥ CZ3457 p7lYdesjTCG￥ https:\/\/m.tb.cn\/h.UQ4ceEA  我的天呐麻酱爆肚粉香辣花甲粉重庆酸辣粉方便速食粉条六袋装",
                            "cps_full_tpwd":"39￥ CZ3457 zRmVdesjTCu￥ https:\/\/m.tb.cn\/h.UQ4cewa  我的天呐麻酱爆肚粉香辣花甲粉重庆酸辣粉方便速食粉条六袋装"
                        },
                        "input_material_url":"s.click.taobao.com",
                        "extra_info":"skuid已失效"
                    }
                ]
            },
            "shop_url_list":{
                "shop_url_list":[
                    {
                        "msg":"无权限",
                        "code":1001,
                        "link_info_dto":{
                            "material_type":2,
                            "seller_id":"123456",
                            "cps_long_url":"https:\/\/s.click.taobao.com\/t?e=m%3D2%26s%3DYryVaqQlYtxw4vFB6t2Z2jAVflQIoZepyK8Cckff7TVRAdhuF14FMU3VlJUC3DsQMMgx22UI05Yc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQJFcOCF3%2FDbwRh53k%2Fssh4t44u6hki9mkh%2BLdPuJoV%2FRzl3tHIK2mthnPjZ5WWqolAEgO5kclpNKBjInADNbJYxEcfNLn7HIXszVe3Fb2x4s%2FJDmTntQaQzGDmntuH4VtA%3D%3D",
                            "cps_short_tpwd":"￥EAqldesjTCt￥",
                            "cps_short_url":"https:\/\/s.click.taobao.com\/FvHjOPu",
                            "cps_full_tpwd":"58￥ CZ3457 EAqldesjTCt￥ https:\/\/m.tb.cn\/h.UQ4ceEB  韩都衣舍旗舰店"
                        },
                        "input_shop_id":"123"
                    }
                ]
            },
            "event_url_list":{
                "event_url_list":[
                    {
                        "msg":"无权限",
                        "code":1001,
                        "link_info_dto":{
                            "material_type":3,
                            "page_id":"20150318020014311",
                            "cps_long_url":"https:\/\/s.click.taobao.com\/t?union_lens=lensId%3AOPT%401671517838%402107457f_128d_1852e3a1e2c_03f5%4001%3BeventPageId%3A20150318020014311&e=m%3D2%26s%3DKQjjrM92%2F7Nw4vFB6t2Z2iperVdZeJviU%2F9%2F0taeK29yINtkUhsv0Dl8FS4ucHenj2w9k21YZ3qgpaE1qudUv106NgiXS75NWi4GdVwNf8BfXAlTvwP7PvyclHulJsGMQ%2BNeRhkrKyfCg%2Fx6BHtN2amAOqUjIVeCy0DxCSzwFgFd1le1%2FF%2FLHa44ut0dMc8VMSJUXveljqoq%2FKh6EC%2FmGEM6gfQ3Aokl5MRYl0%2FyOZHb9no%2FURc5w7o18kPD%2BYRAFveQ9Ld2jorKLJiYzWv6xmKche5LvsSo37%2FLmqNFMyVzwS6VTp1JIFY8eNWMEbfNhDTn1psj9iZsDvbh8Qt7h8A2xIPV%2FpBCPqKNE1%2B%2FpYNizQgXEDae2m%2FrHB9aiVckS6fqAUnbbCiWZ1rWjVK6iMgmy2CsK7djvdOCkVnjXedCpzLnRBhrs1VdGRk68r9XJprbVzmT5j1Xj8w0BzyaviGFCzYOOqAQ",
                            "cps_short_tpwd":"￥PnIodeIlU9z￥",
                            "cps_short_url":"https:\/\/s.click.taobao.com\/EvHjOPu",
                            "cps_full_tpwd":"37￥ CZ3457 PnIodeIlU9z￥ https:\/\/m.tb.cn\/h.UQ4ceEz  22年天猫双旦礼遇季-主会场"
                        },
                        "input_page_id":"203567898765"
                    }
                ]
            },
            "item_url_list":{
                "item_url_list":[
                    {
                        "msg":"无权限",
                        "code":1001,
                        "promotion_info_dto":{
                            "commission_rate":"2.40",
                            "commission_type":"MKT"
                        },
                        "coupon_info_dto":{
                            "coupon_end_time":"2022-12-25 23:59:59",
                            "activity_id":"642208f7db6b4fb9880a9d09832d6b8d",
                            "coupon_remain_count":99987,
                            "coupon_amount":"170.00",
                            "coupon_start_time":"2022-12-20 00:00:00",
                            "coupon_desc":"满319元减170元"
                        },
                        "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&traceId=816a277916715178333831026bf6cf&relationId=123456&&union_lens=lensId:TAPI@1671517838@21055fa7_0b7f_1852e3a1bae_0416@01",
                            "material_type":1,
                            "item_id":"y387e49cRt262Ozub0TvtA-dAeOMBinqPdm6Wxu0",
                            "cps_long_url":"https:\/\/s.click.taobao.com\/t?e=m%3D2%26s%3DvazOG0sd5LJw4vFB6t2Z2ueEDrYVVa64yK8Cckff7TVRAdhuF14FMU3VlJUC3DsQMMgx22UI05Yc28yV8PhABoJJuMl5iAyh8VyU%2FTlgQj6ChAyn0B5LQEVUjoeWqzb%2BCGsxm48e9hkfF%2Bxu0N%2BwWrcZhRlC%2FudiDepej5CXPoiMHuv7RoNv0Q0jFsbsQ7KW1Te9msJWkXsmFF9fm0wobpd0%2BQldqeoBF76lcPm%2FucppnJfkRUzuToD2uOlbI2qURHUT0gmVRp7ZGL0GbiMMd6BniEC%2BBYvRVSjzVV%2FKpYdMm7k2GPZX7L96ZdZH32PNybxY5kax0%2FETNqkNLIJLJkR1E9IJlUaerji63R0xzxUxIlRe96WOqlr6NugmfTu3&union_lens=lensId:TAPI@1671517838@21055fa7_0b7f_1852e3a1bae_0416@01",
                            "cps_short_tpwd":"￥XODHdeIlU9B￥",
                            "coupon_short_tpwd":"￥LOcqdeIlU9y￥",
                            "cps_short_url":"https:\/\/s.click.taobao.com\/GvHjOPu",
                            "coupon_short_url":"https:\/\/s.click.taobao.com\/HvHjOPu",
                            "coupon_full_tpwd":"48￥ CZ3457 LOcqdeIlU9y￥ https:\/\/m.tb.cn\/h.UQ4ceEC  olayks煮茶器喷淋式黑茶白茶煮茶壶家用自动蒸汽养生壶办公室小型",
                            "cps_full_tpwd":"47￥ CZ3457 XODHdeIlU9B￥ https:\/\/m.tb.cn\/h.UQ4ceEy  olayks煮茶器喷淋式黑茶白茶煮茶壶家用自动蒸汽养生壶办公室小型"
                        },
                        "input_item_id":"i87a9ja90d8-09qrjcoa7qwl",
                        "extra_info":"skuid已失效"
                    }
                ]
            }
        },
        "biz_error_desc":1,
        "result_msg":"1"
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

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

淘宝客API

taobao.tbk.dg.general.link.convert (淘宝客-推广者-万能转链)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ