688的API开发接口，我们需要做下面几件事情。
1）开放平台注册开发者账号；
2）然后为每个淘宝应用注册一个应用程序键（App Key) ；
3）下载1688API的SDK并掌握基本的API基础知识和调用；
4）利用SDK接口和对象，传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发；
5）利用淘宝平台的文档中心和API测试工具，对接口进行测试。从而了解返回信息，方便程序获取。
以上是一般淘宝API应用开发的关键流程，其中通过淘宝文档中心和API测试工具，进行概念了解和接口信息查询很重要。因为这些数据就是我们需要在逐步显示出来的。淘宝的API很多，不过都分为了好几个领域，慢慢就会了解深入了。
阿里巴巴中国站按图搜索1688商品（拍立淘） API 返回值说明
请点击注册免费测试
名称 类型 必须 描述
key String 是 调用key
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-/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!211456689.jpg
参数说明：imgid:图片地址（使用淘宝upload_img接口上传图片，返回图片地址）
如:/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
响应参数
名称 类型 是否隐私 示例值 描述
title String 外贸儿童短袖T恤 夏季热销套装 时尚儿童T 宝贝标题
pic_url String /img/ibank//998/799/2913997899_1588191881.jpg 宝贝图片
promotion_price Float 7.00 优惠价
price Float 7.00 价格
price_range Mix [[“6~499”, 8 ], [“≥500”, 7 ] ] 价格范围
sales Int 5 销量
num_iid Bigint 529502304128 宝贝ID
sample_id String 商品风格标识ID
seller_nick String 中山市汇锦制衣有限公司 卖家昵称
post_fee Int 0 物流费用
area String 广东中山市 店铺所在地
detail_url String /offer/529502304128.html 宝贝链接
请求示例
Curl
PHP
PHPsdk
JAVA
C#
Python
– 请求示例 url 默认请求参数已经URL编码处理
curl -i “/1688/api_call.php?key=<您自己的apiKey>&secret=<您自己的apiSecret>&api_name=item_search_img&imgid=http://g-/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!211456689.jpg”
响应示例
异常示例
相关资料
错误码解释
状态代码(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 未知错误 否
