淘口令API接口的本质就是一款调用相关技术的应用程序接口,同时也是一种通过互联网传输数据的方式,可以实现各种各样的应用场景。比如企业运用在分享商品页面的过程中,可以简单组成一个淘口令,以便于分享淘口令。淘口令解析API接口主要的功能就是调用链接解析为淘口令的技术,来帮助企业实现该能力。调用了该接口的企业,在分享淘宝的链接时候,可以将它解析为淘口令,更加方便企业的使用。
公共参数
请求地址: 注册调用key接入
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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 | 原价格 |
PHP请求示例(Curl、PHPsdk、JAVA、Python、Golang、javascript、JS-SDK、Ruby...)
-
- // 请求示例 url 默认请求参数已经URL编码处理
- // 本示例代码未加密secret参数明文传输,若要加密请参考:https://help/demo/sdk/demo-sign.php
- $method = "GET";
- $url = "https://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";
- $curl = curl_init();
- curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
- curl_setopt($curl, CURLOPT_URL, $url);
- curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
- curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
- curl_setopt($curl, CURLOPT_FAILONERROR, false);
- curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
- curl_setopt($curl, CURLOPT_HEADER, true);
- curl_setopt($curl, CURLOPT_ENCODING, "gzip");
- var_dump(curl_exec($curl));
- ?>
响应示例
- {
- "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"
- }