文档中心 > API类目 > 淘宝客【公用】淘口令生成

taobao.tbk.tpwd.create (淘宝客-公用-淘口令生成)

提供淘口令生成接口。提交需要生成淘口令的内容、logo、url等参数,生成淘口令,其中关键信息为¥SADadW¥,后续可基于淘口令进行文案包装组装用于传播。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
url String 必须 https://s.click.taobao.com/YI3Uopu 联盟官方渠道获取的淘客推广链接,请注意,不要随意篡改官方生成的链接,否则可能无法生成淘口令
text String 可选 noMeaningValue 兼容旧版本api参数,无实际作用
logo String 可选 noMeaningValue 兼容旧版本api参数,无实际作用
ext String 可选 noMeaningValue 兼容旧版本api参数,无实际作用
user_id String 可选 noMeaningValue 兼容旧版本api参数,无实际作用

响应参数

名称 类型 示例值 描述
data MapData 返回结果对象
  • └ password_simple
  • String
  • ¥SIH6XbwRfyt¥
  • 非苹果ios14以上版本的设备(即其他ios版本、Android系统等),可以用此淘口令正常在复制到手淘打开
  • └ model
  • String
  • 8緮置内容¥hxlgccEumBB¥达开?τao寶?或掂击炼接 https://m.tb.cn/h.VvkiWSm 至浏.览览.器【618超级红包】
  • 针对苹果ios14及以上版本的苹果设备,手淘将按照示例值信息格式读取淘口令(需包含:数字+羊角符+url,识别规则可能根据ios情况变更)。如需更改淘口令内文案、url等内容,请务必先验证更改后的淘口令在手淘可被识别打开!

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkTpwdCreateRequest req = new TbkTpwdCreateRequest();
req.setUrl("https://s.click.taobao.com/YI3Uopu");
req.setText("noMeaningValue");
req.setLogo("noMeaningValue");
req.setExt("noMeaningValue");
req.setUserId("noMeaningValue");
TbkTpwdCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_tpwd_create_response>
    <data>
        <password_simple>¥SIH6XbwRfyt¥</password_simple>
        <model>8緮置内容¥hxlgccEumBB¥达开?τao寶?或掂击炼接 https://m.tb.cn/h.VvkiWSm 至浏.览览.器【618超级红包】</model>
    </data>
</tbk_tpwd_create_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 服务系统异常 请稍后再试
20000 口令跳转url不支持口令转换 修改口令跳转url,且以https开头
20001 口令弹框内容不能少于5个字符 增加口令弹框内容至5个字符以上
1 服务系统异常 服务系统异常
20002 口令参数扩展字段不能为空 补充口令参数扩展字段
24 淘口令生成者淘宝帐号为空 请检查链接中的pid信息是否正确、合法
25 淘口令生成失败 请重试
23 淘口令链接对应的物料信息为空 请检查链接是否为官方下行的物料链接,请勿随意篡改官方链接
26 链接不属于联盟官方业务场景 请检查链接是否是官方渠道下行,是否被篡改过,是否带有违规参数。

API工具

如何获得此API

FAQ

返回
顶部