接口说明
针对返利平台分享时生成商品淘口令,给用户提供淘口令生成工具
公共参数
请求地址
请求方式
|
GET |
请求地址
|
http://api.tk.net/openapi/create-tkl
|
请求示例
|
http://api.tk.net/openapi/create-tkl?appkey=你的appkey&tid=629363403868 |
公共请求参数
参数名
|
类型
|
是否必须
|
示例值
|
说明
|
appkey
|
string |
是 |
你的appkey |
验证身份凭证 |
接口请求参数
参数名
|
类型
|
是否必须
|
示例值
|
说明
|
tid
|
number |
是 |
629363403868 |
商品id(非必传,tid和url二选一) |
url
|
string |
否 |
https://uland.taobao.com/coupon/edetail?e=La3ZoNLqZxAE%2BdAb1JoOOlObij0XMJ%2FwrHNI9xjEdkCqY1eZxVfQ3vsQs1Ghn59Pdh1GVNNbOvlyHQEpojstHaa92BF7%2BAmRm1tDMTuwb1J%2BpD%2BfWce5N%2Bdth9k8bqqSHKTgBzHkoM7XTQC0vfau6E%2F9Zk7cDx8UGcM%2FmOVXilmllrabRS6m13ui%2Fn%2FQ7Z5V6N4u3Ij2zfE86ds3Wskk0w%3D%3D&traceId=0b5205f416059317357992246e0148&union_lens=lensId:TAPI@1605931735@0b09321d_64f8_175e8fd9b0f_1cef@01&src=shiyue_shiyue&from=tool&sight=shiyue |
优惠券链接(tid和url二选一) |
text
|
string |
否 |
粉丝福利购,快来买啊! |
接收的商品描述文本信息 |
logo
|
string |
否 |
http://img.alicdn.com/imgextra/i3/2207946357938/O1CN01EAegLi28VecBzcz0k_!!2207946357938.jpg_310x310.jpg |
logo的图片地址 |
userid
|
string |
否 |
|
生成口令的淘宝用户ID |
pid
|
String |
否 |
mm_xx_xx_xx |
如果是tid(商品id)生成淘口令,则需要pid和淘宝授权。url生成淘口令则不需要pid和淘宝授权 |
rid
|
string |
否 |
|
渠道运营ID |
sid
|
string |
否 |
|
返利会员运营ID |
activityId
|
string |
否 |
|
自定义优惠券ID |
返回示例
参数名
|
类型
|
示例值
|
说明
|
model
|
string |
0¥jUKDcmrtTSC¥打кǎITá0宔或點缶url链 https://m.tb.cn/h.4ef4p2p 至浏览er【婴幼儿秋冬羊羔绒韩版洋气2020新款毛绒新生儿小童宝宝外穿马甲潮】 |
IOS14系统可以识别的淘口令 |
password_simple
|
string |
¥jUKDcmrtTSC¥ |
含有羊角(¥)符号的淘口令 |
content
|
string |
緮置本段内容¢jUKDcmrtTSC¢到淘tao寳 |
美化之后的淘口令 |
tkl
|
string |
jUKDcmrtTSC |
原淘口令 |
tklone
|
string |
(jUKDcmrtTSC) |
美化之后的淘口令 |
url
|
string |
https://uland.taobao.com/coupon/edetail?e=kUsLZHjJN9QE%2BdAb1JoOOgzt0TFp39gALdOJX9TPW%2BW3tG254baTJEDrbiqllfTHKtGsJ%2FLICLIAcJ9t%2BcAq%2BM5jA6CyKXQ6MSEmlRStydj4wQt%2Byt5OVASU%2Fk70i%2FX%2Fdj3Hchy1wJYuynEbLfMGNjwh43yW%2BFEDaXOtHj5%2Btxt2mjnDzFLX4THx%2FQcHWTt7cW0FAk4P4CLdE6QpS6sRMA%3D%3D&traceId=0bb623a116059358742068006e3d21&union_lens=lensId:TAPI@1605935874@210892a5_09d8_175e93cc0b9_67ed@01&src=shiyue_shiyue&from=tool&sight=shiyue |
淘口令解析后的url/当前淘口令所属url |
正确返回结果
返回示例
错误返回结果
错误返回说明
错误码
|
错误信息
|
解决方案
|
0 |
接口请求失败 |
检查参数或者稍候重试 |
20000 |
口令跳转url不支持口令转换 |
修改口令跳转url,且以https开头 |
20001 |
口令弹框内容不能少于5个字符 |
增加口令弹框内容至5个字符以上 |
20002 |
口令参数扩展字段不能为空 |
补充口令参数扩展字段 |
返回示例