一、接口核心功能

• 用途：通过商品ID（num_iid）获取1688商品全维度详情，包括标题、价格、库存、销量、规格、图片、卖家信息等，支持批发场景数据采集。
• 关键参数：
  • num_iid：商品唯一ID（必填）
  • fields：自定义返回字段（如 title,price,total_sold,pic_url）
  • cache：是否使用缓存（默认yes，提升响应速度）
  • result_type：返回格式（默认json，可选xml/serialize）
  • sales_data：设为1时获取近30天成交数据
  • agent：设为1时获取分销代发价格

二、调用全流程

1. 前期准备

• 注册开发者账号：访问1688开放平台，完成企业认证（个人开发者需申请特殊权限）。
• 创建应用：在控制台「应用管理」中创建应用，选择类型（自用型/第三方），获取 app_key和 app_secret。
• 申请接口权限：在「API列表」中找到 item.get接口，提交权限申请（审核1-3个工作日）。

2. 请求构造

• 认证方式：OAuth2.0，需先获取 access_token（有效期2小时）。
• 签名生成：
  • 参数按ASCII排序后拼接为 key=value&key=value格式
  • 拼接 app_secret后进行MD5加密，转大写
• 示例URL：

  bashhttps://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.get?app_key=YOUR_APP_KEY&num_iid=610947572360&fields=title,price,total_sold&sign=MD5(参数串+app_secret)

3. Python调用示例

pythonimport requestsimport hashlibimport timeapp_key = "YOUR_APP_KEY"app_secret = "YOUR_APP_SECRET"num_iid = "610947572360"params = {    "app_key": app_key,    "method": "alibaba.product.get",    "timestamp": str(int(time.time()*1000)),    "v": "1.0",    "format": "json",    "num_iid": num_iid,    "fields": "title,price,total_sold,pic_url"}# 生成签名sign_str = "".join([f"{k}{params[k]}" for k in sorted(params)]) + app_secretsign = hashlib.md5(sign_str.encode()).hexdigest().upper()params["sign"] = signresponse = requests.get("https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.get", params=params)if response.status_code == 200:    print(response.json())else:    print(f"Error: {response.status_code}")

三、返回数据结构

• 核心字段：

  json{  "item_get_response": {    "item": {      "num_iid": "商品ID",      "title": "商品标题",      "price": "当前价",      "total_sold": "总销量",      "pic_url": "主图URL",      "skus": [{"sku_id": "规格ID", "price": "规格价", "quantity": "库存"}],      "seller_info": {"nick": "卖家昵称", "shop_url": "店铺链接"}    }  }}

四、注意事项

• 频率限制：免费版每日调用上限5000次，企业版可申请提升配额。
• 数据时效：部分字段存在15分钟延迟，需结合业务场景验证。
• 错误处理：
  • 错误码 200表示成功，非200需检查 error_msg字段
  • 常见错误：签名错误、权限不足、参数缺失
• 安全规范：
  • 严禁泄露 app_secret，建议使用环境变量存储
  • 敏感数据需加密处理，遵守《数据安全法》

五、进阶使用

• 分页查询：通过 pageNo和 pageSize参数分批次获取数据
• 关联接口：
  • item_search：按关键词搜索商品
  • seller_info：获取店铺详情
  • item_fee：计算运费

通过本接口可快速搭建商品监控系统、竞品分析工具或供应链管理系统，建议结合官方文档1688开放API文档持续优化调用策略。