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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
password_content String 必须 ¥2kt123e08DjviP¥ 需要解析的淘口令
adzone_id Number 必须 1231212 广告位ID
sub_pid String 必须 mm_11_11_11 三方pid
dx String 可选 1 1表示商品转通用计划链接,其他值或不传表示优先转营销计划链接

响应参数

名称 类型 示例值 描述
data MapData data
  • └ num_iid
  • String
  • 562120815059
  • 商品id
  • └ click_url
  • String
  • https://s.click.taobao.com/t?e=xxx
  • 商品淘客转链

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkTpwdShareConvertRequest req = new TbkTpwdShareConvertRequest();
req.setPasswordContent("¥2kt123e08DjviP¥");
req.setAdzoneId(1231212L);
req.setSubPid("mm_11_11_11");
req.setDx("1");
TbkTpwdShareConvertResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_tpwd_share_convert_response>
    <data>
        <num_iid>562120815059</num_iid>
        <click_url>https://s.click.taobao.com/t?e=xxx</click_url>
    </data>
</tbk_tpwd_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>

错误码解释

错误码 错误描述 解决方案
isp.param-error 参数错误 仔细检查参数
isp.sys-error 服务系统异常 请稍后再试
1 服务系统异常 服务系统异常
10000 该item_id对应宝贝已下架或非淘客宝贝 表示对应的商品可能已下架,或者不属于淘客商品,针对这种场景,无法提供媒体商品url,及商品id,需要媒体特别关注,并自行确定解决方案。
20010 淘口令解析失败 检查输入
20011 淘口令解析结果为空 --
20012 淘口令解析输入口令为空 检查输入
20013 淘口令解析输入subPid格式错误 检查输入
20015 淘口令转链结果为空 --
20016 淘口令转链处理异常 --
4 查询不到对应的adzoneId,请检查adzoneId是否正确 检查输入
isv.parse-result-invalid 淘口令解析结果无效,当前淘口令无效 更换淘口令或稍后重试

API工具

如何获得此API

FAQ

返回
顶部