接口地址:
http://api.web.ecapi.cn/taoke/doShopCovert
接口实例:
http://api.web.ecapi.cn/taoke/doShopCovert?apkey=登录会员中心查看&pid=mm_123456_456789_789132&user_ids=123456,789456&tbname=xxxxxx&relation_id=xxxx
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 |
类型 |
请求参数参考值 |
是否必须 |
说明 |
apkey |
String |
xxxxxxx |
是 |
用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
pid |
String |
mm_123456_456789_789132 |
是 |
淘客PID(注:如已在会员中心设置了默认PID,此参数可无需再次传入) |
user_ids |
String |
123456,789456 |
是 |
商家ID,可传入多个,传入多个时以英文逗号(,)分割,传入多个时暂不生成淘口令及短链接,店铺ID可使用此查询:http://www.ecapi.cn/index/index/openapi/id/49.shtml?ptype=1 |
platformType |
Json |
1 |
|
链接形式:1:PC,2:无线,默认:1 |
tbname |
String |
xxxxxx |
是 |
在本平台授权的淘客账号所对应的用户名,见“会员中心”-“账号授权”-“淘宝授权”列表页 |
shorturl |
Number |
1 |
|
是否生成短链接,1=生成,不填或填写其他为不生成,当商家ID为多个时,此参数不生效 |
tpwd |
Number |
1 |
|
是否生成淘口令,1为生成,不填或填写其他为不生成,如果生成,则tpwdtitle参数必须传入,当商家ID为多个时此参数不生效 |
tpwdpic |
String |
http://www.baidu.com/1.jpg |
|
打开口令时显示的Logo图片 |
tpwdtitle |
String |
xxxxxx |
|
打开口令时的提示文字,生成口令时必填 |
unid |
String |
xxxxxx |
|
自定义输入串,英文和数字组成,长度不能大于12个字符,区分不同的推广渠道 |
relation_id |
String |
xxxx |
是 |
渠道ID,获取说明:https://doc.21ds.cn/detail?doc=4685763267728060/4970875219793639(注:如已在会员中心设置了默认渠道ID,此参数可无需再次传入) |
-
返回参数
-
返回参数 |
类型 |
参数说明 |
扩展说明 |
click_url |
String |
生成的店铺淘客链接 |
|
user_id |
String |
生成店铺淘客链接对应的店铺ID |
|
-
Json返回示例
-
{"code":200,"data":[{"click_url":"https://s.click.taobao.com/t?e=m=2&s=8TUUxxxxxxxxion_lens=lensId:0b0f8444_5a63_16e6a4c0ee3_39a9","user_id":767xxxx56}],"msg":"success"}
-
code/http_status说明
-
code/http_status |
说明 |
200 |
数据获取成功 |
-1 |
数据获取失败 |
401 |
IP没有添加白名单 |
429 |
访问次数超限 |
403 |
关键参数丢失 |
405 |
请求方式不对 |