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

taobao.tbk.sc.tpwd.convert (淘宝客-服务商-淘口令解析&转链)

支持通过淘口令解析商品id,并提供对应的淘客转链接

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
password_content String 必须 ¥2k12308DjviP¥ 需要解析的淘口令
adzone_id Number 必须 12312312 广告位ID,mm_xx_xx_xx pid三段式中的第三段
dx String 可选 1 1表示商品转通用计划链接,其他值或不传表示优先转营销计划链接
site_id Number 必须 1 备案的网站id, mm_xx_xx_xx pid三段式中的第二段
ucrowd_id Number 可选 1 会员人群ID,用于统计人群推广效果
relation_id String 可选 123 渠道id

响应参数

名称 类型 示例值 描述
data MapData map data
  • └ num_iid
  • String
  • 12312
  • 商品Id
  • └ click_url
  • String
  • https://s.click.taobao.com/t?e=xxx
  • 商品淘客转链链接
  • └ seller_id
  • String
  • 12121
  • 店铺卖家ID
  • └ origin_url
  • String
  • https://s.click.taobao.com/t?e=xxx
  • 入参淘口令对应原始链接
  • └ origin_pid
  • String
  • mm_1_1_1
  • 入参淘口令推广链接中的pid,如果不属于当前调用的推广者则展示“0”
  • └ biz_scene_id
  • String
  • 1
  • 1-动态ID转链场景,2-消费者比价场景,3-商品库导购场景
  • └ model
  • String
  • ¥VWRr2yvEvsz¥
  • 转链后的短口令。非苹果ios14以上版本的设备(即其他ios版本、Android系统等),可以用此淘口令正常在复制到手淘打开
  • └ password
  • String
  • 89¥ CZ3457 VWRr2yvEvsz¥ https://m.tb.cn/h.UdPLKzy
  • 转链后的长口令。针对苹果ios14及以上版本的苹果设备,手淘将按照示例值信息格式读取淘口令。如需更改淘口令内文案、url等内容,请务必先验证更改后的淘口令在手淘可被识别打开!
  • └ short_url
  • String
  • https://s.click.taobao.com/vpIZmSu
  • 转链后的短链接
  • └ url_type
  • String
  • 1
  • 原链接类型:1-单品,2-店铺,3-活动,0-其它
  • └ isv_mktid
  • String
  • aisj979ld8-8asdbalaiu
  • 根据入参工具服务商账号信息生成的新商品ID

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkScTpwdConvertRequest req = new TbkScTpwdConvertRequest();
req.setPasswordContent("¥2k12308DjviP¥");
req.setAdzoneId(12312312L);
req.setDx("1");
req.setSiteId(1L);
req.setUcrowdId(1L);
req.setRelationId("123");
TbkScTpwdConvertResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_sc_tpwd_convert_response>
    <data>
        <num_iid>12312</num_iid>
        <click_url>https://s.click.taobao.com/t?e=xxx</click_url>
        <seller_id>12121</seller_id>
        <origin_url>https://s.click.taobao.com/t?e=xxx</origin_url>
        <origin_pid>mm_1_1_1</origin_pid>
        <biz_scene_id>1</biz_scene_id>
        <model>¥VWRr2yvEvsz¥</model>
        <password>89¥ CZ3457 VWRr2yvEvsz¥ https://m.tb.cn/h.UdPLKzy</password>
        <short_url>https://s.click.taobao.com/vpIZmSu</short_url>
        <url_type>1</url_type>
        <isv_mktid>aisj979ld8-8asdbalaiu</isv_mktid>
    </data>
</tbk_sc_tpwd_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>

错误码解释

错误码 错误描述 解决方案
20010 淘口令解析失败 检查输入
20011 淘口令解析结果为空 更换淘口令或稍后重试
20012 淘口令解析输入口令为空 检查输入
20013 淘口令解析输入subPid格式错误 检查输入
20015 淘口令转链结果为空 更换淘口令或稍后重试
4 查询不到对应的adzoneId,请检查adzoneId是否正确 检查输入
2 pid不正确 检查输入
20014 淘口令转链入参不合法 检查淘口令入参
10000 该item_id对应宝贝已下架或非淘客宝贝 更换淘口令
1 内部服务不可用 稍后重试
20016 淘口令转链处理异常 稍后重试
isp.tpwd-parse-error 淘口令解析服务出错,一般为淘口令不存在 更换有效淘口令或稍后重试
isv.parse-result-invalid 淘口令解析结果无效,当前淘口令无效 更换淘口令或稍后重试
20008 淘口令解析结果无效,当前淘口令无效 更换淘口令或稍后重试
0 内部服务不可用 稍后重试
isp.sys-error 内部服务不可用 稍后重试
-4001 请查看API返回日志确定具体原因 请查看API返回日志确定具体原因

API工具

如何获得此API

FAQ

返回
顶部