淘宝拍立淘功能接入分享

数字化图片化的时代，通过商品图片搜索需要的商品已经是现代人购物的日常。那么作为商家，如何使用这一功能，使自己的商品能通过图片搜索出来呢？ 这里就需要两个API接口。 一个## upload_img-上传图片到淘宝的接口。一个是## item_search_img-按图搜索淘宝商品（拍立淘）。我们先上传后进行搜索，图片用post上传或者直传file 图片尺寸建议50*50。下面分享实现图片搜索的经验，申请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版本

请求参数

请求参数：imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=

参数说明：imgid:图片地址（支持淘宝或天猫图片地址，外部地址先调用上传图片(upload_img)接口，返回图片地址）
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg

响应参数

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	宝贝链接

同时我们还要upload_img-上传图片到淘宝 

公共参数

请求地址:同上申请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版本

请求参数

请求参数：imgcode=https://img14.360buyimg.com/n0/jfs/t1/52280/38/7464/140698/5d511f6bE08290bd7/f0bb32ddb47451e8.jpg

参数说明：imgcode:base64加密后的图片内容(post方式),或者是直接上传(file方式)

响应参数

Version: Date:

名称	类型	必须	示例值	描述
status	Int	0	1	状态码
name	String	0	TB14_f0bsrrK1Rjy1zeXXXalFXa	图片名称
url	String	0	//g-search3.alicdn.com/img/bao/uploaded/i4/TB14_f0bsrrK1Rjy1zeXXXalFXa	图片URL
error	String	0	false	错误信息
extraInfo	String	0	width:430height:430size=26429	图片额外信息

值得注意的是图片用post上传或者直传file 图片尺寸建议50*50先上传后进行搜索