1688平台获取店铺所有商品列表API接口技术详解

​

在电商开发中，集成1688平台的API是获取店铺商品数据的关键。1688是阿里巴巴旗下的B2B批发平台，其API接口允许开发者通过编程方式访问店铺的商品列表，用于数据分析、库存管理或第三方应用开发。本帖子将逐步介绍如何调用1688平台的“获取店铺所有商品列表”API接口，包括认证、请求参数、响应处理和代码实现。内容基于公开API文档，确保真实可靠。

1. API接口概述

1688平台的API提供了多种功能，其中“获取店铺所有商品列表”接口用于查询指定店铺下的全部商品信息。该接口通常采用RESTful风格，使用HTTP GET或POST方法，返回JSON格式数据。主要用途包括：

批量导出商品数据。

同步店铺商品到其他系统。

实时监控商品状态。

在调用前，您需要具备1688开发者账号和API访问权限。如果您尚未注册，请前往1688开放平台（open.1688.com）申请开发者账号并创建应用，以获取必要的认证信息。

2. 准备工作：获取API认证信息

调用API前，需完成以下步骤：

注册开发者账号：在1688开放平台注册并登录。

创建应用：在开发者控制台创建新应用，选择“店铺API”权限。

获取API密钥：应用创建后，系统会生成app_key和app_secret，用于API认证。

获取访问令牌（access_token）：通过OAuth2.0授权流程获取access_token。通常需用户授权后，使用app_key和app_secret换取令牌。示例授权URL为：

https://auth.1688.com/authorize?response_type=code&client_id=YOUR_APP_KEY&redirect_uri=YOUR_REDIRECT_URI

替换YOUR_APP_KEY和YOUR_REDIRECT_URI为您的实际值。

3. API调用细节

API请求包括URL、方法、参数和头信息。以下是关键要素：

请求URL：
标准接口URL为：

https://api.1688.com/router/rest?method=alibaba.product.get.list

其中alibaba.product.get.list是方法名，需根据API文档确认最新版本。

HTTP方法：
通常使用GET方法，但某些场景可能需POST。确保设置正确的Content-Type头为application/x-www-form-urlencoded。

请求参数：
参数需通过查询字符串或请求体传递。主要参数包括：

access_token：必填，您的访问令牌。

seller_id：必填，店铺的卖家ID。

page_no：可选，分页页码，默认1。

page_size：可选，每页商品数量，默认20，最大100。

fields：可选，指定返回字段，如product_id,title,price，默认返回全部。

请求头：
设置必要的头信息：

Authorization: Bearer YOUR_ACCESS_TOKEN

Content-Type: application/x-www-form-urlencoded（如果使用POST）

4. 响应处理

API响应为JSON格式，包含状态码、数据和分页信息。典型响应结构如下：

{
  "result": {
    "success": true,
    "message": "success",
    "total_results": 150,
    "products": [
      {
        "product_id": "123456",
        "title": "示例商品",
        "price": 100.00,
        "status": "active"
      },
      // 更多商品...
    ]
  },
  "error_code": "0",
  "error_message": ""
}

关键字段：

success：布尔值，表示请求是否成功。

total_results：整数，总商品数量。

products：数组，包含商品详情。

error_code和error_message：处理错误时参考。

解析响应时，检查success字段。如果为false，需处理错误，常见错误码包括：

400：参数错误。

401：认证失败。

429：请求频率过高（限流）。

5. 代码示例：Python实现

以下Python示例演示如何调用API，使用requests库处理HTTP请求。确保安装requests库：pip install requests。

import requests
import urllib.parse

# 配置参数
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"  # 实际使用中，app_secret应保密，避免硬编码
access_token = "YOUR_ACCESS_TOKEN"  # 通过OAuth流程获取
seller_id = "SELLER_ID"  # 目标店铺的卖家ID
page_no = 1
page_size = 50

# 构建请求URL和参数
base_url = "https://api.1688.com/router/rest"
params = {
    "method": "alibaba.product.get.list",
    "access_token": access_token,
    "seller_id": seller_id,
    "page_no": page_no,
    "page_size": page_size,
    "fields": "product_id,title,price,status"
}
# URL编码参数
encoded_params = urllib.parse.urlencode(params)
full_url = f"{base_url}?{encoded_params}"

# 发送GET请求
response = requests.get(full_url)
if response.status_code == 200:
    data = response.json()
    if data.get("result", {}).get("success"):
        products = data["result"]["products"]
        total = data["result"]["total_results"]
        print(f"成功获取 {len(products)} 个商品，总计 {total} 个商品。")
        for product in products:
            print(f"商品ID: {product['product_id']}, 标题: {product['title']}, 价格: {product['price']}")
    else:
        error_code = data.get("error_code", "未知")
        error_msg = data.get("error_message", "无错误信息")
        print(f"API错误: 代码 {error_code}, 消息: {error_msg}")
else:
    print(f"HTTP错误: 状态码 {response.status_code}")

6. 常见问题与注意事项

限流处理：1688 API有请求频率限制（如每分钟100次）。建议使用指数退避重试策略。

错误处理：捕获常见错误，如网络异常或认证过期。定期刷新access_token（有效期通常2小时）。

分页逻辑：如果商品数量大，需循环调用API直到page_no * page_size >= total_results。

数据安全：避免在客户端存储app_secret，使用服务器端代理调用。

测试环境：先在沙箱环境测试，URL可能为sandbox.api.1688.com。

7. 结论

通过1688平台的“获取店铺所有商品列表”API，开发者能高效集成商品数据，支持业务自动化。本帖子提供了从认证到代码实现的完整指南，确保您能快速上手。如需更多帮助，参考1688开放平台官方文档或社区论坛。实践中，注意遵守API使用条款，避免滥用。如果您有特定问题，欢迎在评论区讨论！

​审核编辑 黄宇