为了进行淘宝的API开发,首先我们需要做下面几件事情。
1)开发者注册一个账号
2)然后为每个淘宝应用注册一个应用程序键(App Key) 。
3)下载淘宝API的SDK并掌握基本的API基础知识和调用
4)利用SDK接口和对象,传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发。
5)利用淘宝平台的文档中心和API测试工具,对接口进行测试。从而了解返回信息,方便程序获取。
以上是一般淘宝API应用开发的关键流程,其中通过淘宝文档中心和API测试工具,进行概念了解和接口信息查询很重要。因为这些数据就是我们需要在逐步显示出来的。淘宝的API很多,不过都分为了好几个领域,慢慢就会了解深入了。
淘宝/天猫按图搜索淘宝商品(拍立淘) API 返回值说明
item_search_img-按图搜索淘宝商品(拍立淘)
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
请求参数:imgid=g-search3.alicdn.com/img/bao/upl…
参数说明:imgid:图片地址(支持淘宝或天猫图片地址,外部地址先调用上传图片(upload_img)接口,返回图片地址)
如:img.alicdn.com/imgextra/i3…
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| title | String | 0 | 亲子装短袖t恤社会人衣服全家装一家三口母子母女纯棉夏装上衣潮 | 宝贝标题 |
| cid | Int | 0 | 50015374 | |
| list_type | String | 0 | 外观相似宝贝 | 列表类型 |
| pic_url | String | 0 | //g-search3.alicdn.com/img/bao/uploaded/i4/TB26ry1rBsmBKNjSZFsXXaXSVXa_!!2628705716.jpg | 宝贝图片 |
| promotion_price | String | 0 | 38.71 | 优惠价 |
| price | Float | 0 | 39.50 | 价格 |
| sales | Int | 0 | 7 | 销量 |
| num_iid | Bigint | 0 | 575727312808 | 宝贝ID |
| sample_id | Bigint | 0 | 1627115368 | 商品风格标识ID |
| seller_nick | String | 0 | 专属味道之dzw | 掌柜昵称 |
| is_tmall | Bool | 0 | false | |
| post_fee | String | 0 | 0.00 | 物流费用 |
| area | String | 0 | 广东 东莞 | 店铺所在地 |
| detail_url | String | 0 | //item.taobao.com/item.htm?id=575727312808&ns=1#detail | 宝贝链接 |
Curl PHP PHPsdk JAVA C# Python
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.onebound.cn/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)