1688店铺商品API开发指南

获取key

一、接口概述

1688开放平台精心打造了alibaba.product.list.get接口，助力企业高效获取店铺内所有商品数据。此接口要求使用企业认证账号，并提前申请API权限。在当前电商数据量呈爆发式增长的背景下，该接口支持分页查询功能（每页固定展示50条数据），可精准返回商品ID、标题、价格、库存等核心字段，为企业商品管理和营销策略制定提供有力数据支撑。

二、准备工作

1. 注册账号：前往1688开放平台官网，完成账号注册流程。
2. 创建应用：成功注册后，在平台内创建应用，获取专属的AppKey和AppSecret，这两者是后续调用接口的重要凭证。
3. 申请权限：在平台权限管理页面，申请【商品信息查询】API权限，只有获得该权限，才能正常调用相关接口获取商品数据。

三、Java调用示例

java
import com.aliyun.openservices.aliyun.inter.*;
import java.util.HashMap;
import java.util.Map;
 
public class AlibabaProductAPI {
   
   private static final String APP_KEY = "your_app_key";
   private static final String APP_SECRET = "your_app_secret";
   private static final String API_URL = "https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.list.get/";
   
   public static void main(String[] args) {
       Map<String, String> params = new HashMap<>();
       params.put("pageNo", "1");  // 设置查询页码，从1开始
       params.put("pageSize", "50");  // 每页显示50条数据
       params.put("productType", "all");  // 查询所有类型商品
       
       try {
           // 发送请求并获取响应结果
           String result = AliRequestUtil.sendRequest(API_URL, APP_KEY, APP_SECRET, params);
           System.out.println("API响应：" + result);
       } catch (Exception e) {
           e.printStackTrace();
       }
   }
}

四、返回数据解析

成功响应示例（JSON格式）：

json
{
 "success": true,
 "result": {
   "total": 120,  // 商品总数量
   "products": [
     {
       "productID": "12345678",  // 商品唯一标识ID
       "title": "新款智能手机",  // 商品标题
       "price": "299.00",  // 商品价格
       "stock": 500,  // 商品库存数量
       "imageUrl": "https://example.com/img.jpg"  // 商品图片链接
     }
   ]
 }
}

五、注意事项

1. 调用限额：为保障平台稳定运行，该接口设置了每日调用限额为5000次，企业在调用时需合理规划调用频率，避免超出限额。
2. 分页处理：由于接口支持分页查询，当商品数量较多时，需通过pageNo循环请求，以获取所有商品数据，确保数据的完整性。
3. 数据安全：在数据传输过程中，敏感字段需进行加密处理，防止数据泄露，保障企业和用户的信息安全。
4. 简化流程：建议使用官方提供的SDK，它能够简化签名流程，降低开发难度，提高开发效率。