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

taobao.tbk.tpwd.convert (淘宝客-推广者-淘口令解析&转链)

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
password_content String 必须 ¥2k12308DjviP¥ 需要解析的淘口令
adzone_id Number 必须 12312312 广告位ID
dx String 可选 1 1表示商品转通用计划链接,其他值或不传表示优先转营销计划链接
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¥
  • 短口令
  • └ password
  • String
  • 37¥ CZ3457 h6s32DqCJML¥ https://m.tb.cn/h.UX2rIfT 路路手撕肉干香辣味麻辣原味混合熟食真空小包装鸭肉风干肉条零食【立即领券】
  • 长口令
  • └ url_type
  • String
  • 1
  • 链接类型。1-单品,2-店铺,3-活动,0-其它
  • └ short_url
  • String
  • https://s.click.taobao.com/vpIZmSu
  • 短链接

请求示例

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

响应示例

  • XML示例
  • JSON示例
<tbk_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>37¥ CZ3457 h6s32DqCJML¥ https://m.tb.cn/h.UX2rIfT  路路手撕肉干香辣味麻辣原味混合熟食真空小包装鸭肉风干肉条零食【立即领券】</password>
        <url_type>1</url_type>
        <short_url>https://s.click.taobao.com/vpIZmSu</short_url>
    </data>
</tbk_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是否正确 检查输入
isp.param-error 参数错误 仔细检查参数
isp.sys-error 服务系统异常 请稍后再试
1 服务系统异常 服务系统异常
10000 该item_id对应宝贝已下架或非淘客宝贝 表示对应的商品可能已下架,或者不属于淘客商品,针对这种场景,无法提供媒体商品url,及商品id,需要媒体特别关注,并自行确定解决方案。
20016 淘口令转链处理异常 --
2 pid不正确 检查输入
20014 淘口令转链入参不合法 检查淘口令入参
isv.parse-result-invalid 淘口令解析结果无效,当前淘口令无效 更换淘口令或稍后重试
20008 淘口令解析结果无效,当前淘口令无效 更换淘口令或稍后重试
0 内部服务不可用 稍后重试

API工具

如何获得此API

FAQ

返回
顶部