API 是一组定义、程序及协议的集合，主要功能是提供通用功能集，实现计算机软件之间的相互通信。我们通过 API 接口可以实现特定的功能，而不需要了解其内部实现细节。可以把 API 接口理解为是特定服务的一种封装，将服务封装起来提供给他人调用，这样一来很多功能不需要从新开发。
1、公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（获取测试key和secret） |
| 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版本 |
2、请求参数
请求参数：imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg
参数说明：imgid:图片地址（使用淘宝upload_img接口上传图片，返回图片地址）
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
3、响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
|
items |
items[] | 0 | 按图搜索1688商品 | |
|
real_total_results |
Int | 0 | 80 | 宝贝真实数量 |
|
total_results |
Int | 0 | 43 | 搜索数量 |
|
pagecount |
Int | 0 | 1 | 总页数 |
|
error |
String | 0 | 错误代码 | |
|
data_from |
String | 0 | ||
|
item |
item[] | 0 | 宝贝详情数据 | |
|
title |
String | 0 | 外贸儿童短袖T恤 夏季热销套装 时尚儿童T | 宝贝标题 |
|
pic_url |
String | 0 | https://cbu01.alicdn.com/img/ibank/2016/998/799/2913997899_1588191881.jpg | 宝贝图片 |
|
price |
Float | 0 | 7.00 | 价格 |
|
sales |
Int | 0 | 5 | 销量 |
|
num_iid |
Bigint | 0 | 529502304128 | 宝贝ID |
|
turnHead |
String | 0 | 23.5% | 回头率 |
|
seller_nick |
String | 0 | 中山市汇锦制衣有限公司 | 卖家昵称 |
|
area |
String | 0 | 广东中山市 | 店铺所在地 |
|
detail_url |
String | 0 | https://detail.1688.com/offer/529502304128.html | 宝贝链接 |
来源：Hardy的博客
声明：本站部分文章及图片转载于互联网，内容版权归原作者所有，如本站任何资料有侵权请您尽早请联系jinwei@zod.com.cn进行处理,非常感谢！