全部
淘宝客
在线测试
淘宝客-公用-长链转短链
接口地址： http://api.vv-tool.com/tool/taobaoke/tbkspread
接口介绍： 输入一个原始的链接，转换得到指定的传播方式，如二维码，淘口令，短连接； 现阶段只支持短连接。点击查看详情
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 联系运营
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| requests | TbkSpreadRequest[] | true | 请求列表，内部包含多个 url | |
| -url | String | true | http://temai.taobao.com | 原始 url, 只支持 uland.taobao.com，s.click.taobao.com， ai.taobao.com，temai.taobao.com 的域名转换，否则判错 |
| taobao_user_id | Int | true | 123 | 授权的用户 ID |
请求示例
{
"requests":[
{
"url":"http://s.click.taobao.com/t?e=m%3D2%26s%3DMzGvqf5706wcQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0Mb5HE%2F1MzuAxSj%2FdG%2F%2BikJoa7aze8VfzILxoap%2B%2FYz8vcPqO1FKbghk9F7u1u5eifuzV7pzkENNSBaygToy7XnUr8WZJ6OtvrG5hBzwUurRSRc3PgFy2%2BWteK%2Fp%2BjtO4sCY0%2FrGuVtlIYULNg46oBA%3D&scm=null&pvid=100_11.229.159.208_165032_3031659686643031644&app_pvid=59590_33.3.211.241_864_1659686643027&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.229.159.208_165032_3031659686643031644;app_pvid:59590_33.3.211.241_864_1659686643027&xId=1bk7N77dmBNmetQwCt0YSyZQKZmlrjHZMFD0y6YTwpZlg5fXjxhhHEiCvwIVeWARcqNNGrf3LV9iicATwvx1nmcEb6SU4cDigJNNH0tBMpGB&union_lens=lensId%3AMAPI%401659686643%402103d3f1_0c03_1826d0865e1_9ca4%4001"
}
]
,"taobao_user_id":"123"
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| results | TbkSpread [] | 传播形式对象列表 | |
| content | String | http://s.click.taobao.com/H4zazPx | 传播形式， 目前只支持短链接 |
| err_msg | String | OK | 调用错误信息；由于是批量接口，请重点关注每条请求返回的结果，如果非 OK，则说明该结果对应的 content 不正常，请酌情处理; |
| total_results | Number | 10 | totalResults |
| withholding_money | INT | 11 | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "成功",
"msec": 452,
"time": 1659948867,
"data": {
"request_id": "15rruueaq3s0r",
"Body": "",
"results": [
{
"content": "https://s.click.taobao.com/kYaqwUu",
"err_msg": "OK"
}
],
"total_results": 1,
"withholding_money": 0
}
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 202 | 系统错误，请稍后再试 | 稍后重试，或者联系对接群 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |
| 401 | 身份凭证无效 | 在请求头中添加 access_token，重新更新 token |
| 404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |