一、背景介绍

   1688.com是阿里旗下国内最大的B2B批发采购平台，1688分销客是依托此平台的官方营销平台，通过此平台API接口的接入推广平台商家的商品，按照商品成交金额的一定比例获得佣金。可以调用1688平台上的商品详情，SKU数据，商品描述。

1688 API 接入说明

1. API地址:申请调用KEY测试地址

2. 调用示例：

3. 参数说明

   • 通用参数说明

     • version:API版本
     • key:调用key,测试key:test_api_key
     • api_name:API类型[item_get,item_search]
     • cache:[yes,no]默认yes，将调用缓存的数据，速度比较快
     • result_type:[json,xml,serialize,var_export]返回数据格式，默认为json
     • lang:[cn,en,ru] 翻译语言，默认cn简体中文

   • API:item_get 参数说明: num_iid:宝贝ID

4. 此API目前支持以下基本接口：

   • item_get 获得1688商品详情
   • item_search 按关键字搜索商品
   • item_search_img 按图搜索1688商品（拍立淘）
   • item_search_suggest 获得搜索词推荐
   • item_fee 获得商品快递费用
   • seller_info 获得店铺详情
   • item_search_shop 获得店铺的所有商品
   • item_password 获得淘口令真实url
   • upload_img 上传图片到1688
   • item_search_seller 搜索店铺列表
   • img2text 图片识别商品接口
   • item_get_app 获取1688app上原数据
   • buyer_order_list 获取购买到的商品订单列表
   • cat_get 获得1688商品分类

公共参数

名称	类型	必须	描述
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版本

请求参数

请求参数：num_iid=610947572360

参数说明：num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据

响应参数

Version: Date:

名称	类型	必须	示例值	描述
item	item[]	0		宝贝详情数据