淘宝/天猫平台并没有直接提供将淘口令转换为真实URL的API接口。淘口令是淘宝/天猫平台的一种特殊链接形式,通常用于在社交媒体或其他平台上分享商品或活动信息。用户复制淘口令后,在淘宝/天猫应用中打开,即可直接跳转到相应的商品或活动页面。
一、参数
公共参数
请求地址:
https://api-gw.onebound.cn/taobao/item_password
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:word=urlencode(fu置本段内容₤qQkYcb86z2d₤咑幵τao寶或点几链街https://m.tb.cn/h.VudJ7MB?sm=ef28da 至瀏lan嘂..【幼儿童数字积木拼图玩具宝宝早教益智力开发动脑1-2岁半3男孩女孩】)&title=no
参数说明:word:淘口令代码(支持短网址、商品url)
title:是否获取标题和图片
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iid | Bigint | 0 | 572050066584 | 宝贝ID |
url | String | 0 | http://c.b1wt.com/h.31XFxO?cv=tOacluJFVM&sm=bfce20 | 淘口令真实url |
word | String | 0 | http://c.b1wt.com/h.31XFxO?cv=tOacluJFVM&sm=bfce20 | 淘口令内容 |
error | String | 0 | error taobao password | 错误提示 |
title | String | 0 | 三浅陶社 奶喵喵陶瓷咖啡杯 手工手绘情侣杯 碟下午茶茶杯茶具 | 宝贝标题 |
pic_url | String | 0 | //img.alicdn.com/imgextra/i1/TB1yyCjPpXXXXX4aXXXXXXXXXXX_!!0-item_pic.jpg | 图片地址 |
price | Float | 0 | 160.00 | 价格 |
orginal_price | Float | 0 | 160.00 | 原价格 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/taobao/item_password/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&word=urlencode(fu置本段内容₤qQkYcb86z2d₤咑幵τao寶或点几链街https://m.tb.cn/h.VudJ7MB?sm=ef28da 至瀏lan嘂..【幼儿童数字积木拼图玩具宝宝早教益智力开发动脑1-2岁半3男孩女孩】)&title=no"
响应示例
{
"item": {
"num_iid": "13734572962",
"url": "https://item.taobao.com/item.htm?id=13734572962",
"word": "https://item.taobao.com/item.htm?id=13734572962",
"password_type": "url",
"error": "",
"title": "三浅陶社 奶喵喵陶瓷咖啡杯 手工手绘情侣杯 碟下午茶茶杯茶具",
"pic_url": "//img.alicdn.com/imgextra/i1/TB1yyCjPpXXXXX4aXXXXXXXXXXX_!!0-item_pic.jpg",
"price": 160,
"orginal_price": "160.00"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:6386 max:15000",
"execution_time": 1.164,
"server_time": "Beijing/2020-06-15 18:57:40",
"call_args": {
"num_iid": "13734572962"
},
"api_type": "taobao",
"request_id": "15ee75422ea6a4"
}
异常示例
相关资料
可以以下方式获取商品参数或者带标题图片,然后再根据ID调用 item_get接口获取完整详情数据
参数示例
1、混合模式
word=【雪地厚底内增高女棉鞋2019新款秋冬季加绒冬鞋英伦风秋款马丁短靴】https://m.tb.cn/h.eyRNZ0j?sm=a8c134 點ゞ撃°鏈ㄣ接,再选择瀏覽嘂..咑№亓;或復zんíゞ这句话¢ogE81a50uPl¢后咑閞
2、短网址方式
word=https://m.tb.cn/h.eyRNZ0j?sm=a8c134
3、纯淘口令方式
word=¢ogE81a50uPl¢
4、原始商品URL方式
word=https://item.taobao.com/item.htm?id=13734572962
错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
由于淘口令的生成和解析涉及到淘宝/天猫平台的内部逻辑和算法,这些逻辑和算法并未通过API接口对外开放。因此,开发者无法通过调用API接口来直接获取淘口令对应的真实URL。
如果您需要在自己的应用或网站中实现类似的功能,您可以考虑以下方案:
-
用户自行打开淘口令:
引导用户复制淘口令后,在淘宝/天猫应用中打开。这样,用户可以直接跳转到相应的商品或活动页面。这种方式不需要开发者进行额外的处理,但需要用户的配合和主动操作。 -
使用第三方服务:
有些第三方服务商可能提供了将淘口令转换为真实URL的服务。您可以搜索并了解这些服务商提供的解决方案,但请注意选择可靠和合规的服务商,并确保遵守淘宝/天猫平台的使用条款和规定。
需要注意的是,由于淘口令的生成和解析逻辑可能随时发生变化,任何基于当前逻辑实现的解析方案都可能在未来失效。因此,建议您在开发过程中保持对淘宝/天猫平台更新和变化的关注,并及时调整您的解决方案。
如果您在开发过程中遇到任何问题或需要进一步的帮助,建议直接联系淘宝/天猫的开放平台技术支持团队或访问相关的开发者社区和论坛。