微店商品列表API使用指南

一、摘要

你需要的微店商品列表 API 是微店开放平台提供的核心接口之一，主要用于获取指定微店店铺的商品列表数据，支持按商品状态、分类、分页等条件筛选，是实现微店商品管理、数据同步、店铺运营分析等场景的基础接口。该接口需通过合法的开发者身份调用，返回结构化的商品信息（如标题、价格、库存、图片等）。

二、接口概述

1. 前置条件

• 创建应用并审核通过，获取appkey（应用 ID）、appsecret（应用密钥）；
• 通过appkey和appsecret获取access_token（接口调用凭证，有效期通常为 2 小时）；
• 确保调用接口的店铺已授权给你的应用。

2. 核心接口信息

3. 关键请求参数

4. 响应参数（核心字段）

json

{ "errcode": 0, // 返回码，0表示成功 "errmsg": "success", // 返回信息 "data": { "total": 100, // 商品总数 "items": [ // 商品列表 { "item_id": "123456", // 商品ID "title": "XX商品标题", // 商品标题 "price": 99.00, // 售价（元） "stock": 1000, // 库存 "main_img": "https://xxx.jpg", // 主图URL "status": 1 // 商品状态（1=上架） } ] } }

5. 常见返回码

三、Python 请求示例

1. 前置准备

先安装请求库：

bash

pip install requests

2. 完整调用代码

python

import requests import json def get_weidian_access_token(appkey, appsecret): """ 第一步：获取access_token（示例，实际需按微店开放平台文档调整） """ token_url = "https://api.weidian.com/oauth/access_token" token_params = { "appkey": appkey, "appsecret": appsecret, "grant_type": "client_credential" # 客户端凭证模式，需确认平台支持的授权模式 } try: response = requests.get(token_url, params=token_params, timeout=10) response.raise_for_status() # 抛出HTTP错误 result = response.json() if result.get("errcode") == 0: return result.get("access_token") else: print(f"获取token失败：{result.get('errmsg')}") return None except Exception as e: print(f"获取token异常：{str(e)}") return None def get_weidian_goods_list(access_token, shop_id, page=1, page_size=20): """ 第二步：调用商品列表API :param access_token: 接口调用凭证 :param shop_id: 店铺ID :param page: 页码 :param page_size: 每页条数 :return: 商品列表数据（dict） """ # 接口地址 api_url = "https://api.weidian.com/router/rest" # 请求参数 request_data = { "method": "weidian.item.list.get", "access_token": access_token, "shop_id": shop_id, "page": page, "page_size": page_size, "status": 1 # 只获取上架商品 } try: # 发送POST请求 response = requests.post( api_url, data=json.dumps(request_data), headers={"Content-Type": "application/json;charset=UTF-8"}, timeout=15 ) # 解析响应 result = response.json() # 处理响应结果 if result.get("errcode") == 0: return { "total": result["data"]["total"], "goods": result["data"]["items"] } else: print(f"调用商品列表API失败：{result.get('errmsg')}") return None except requests.exceptions.RequestException as e: print(f"请求异常：{str(e)}") return None except KeyError as e: print(f"响应数据格式异常，缺少字段：{str(e)}") return None # 主程序调用 if __name__ == "__main__": # 替换为你的实际信息 APPKEY = "你的appkey" APPSECRET = "你的appsecret" SHOP_ID = "你的店铺ID" # 1. 获取access_token token = get_weidian_access_token(APPKEY, APPSECRET) if not token: exit("无法获取access_token，程序终止") # 2. 获取商品列表 goods_data = get_weidian_goods_list(token, SHOP_ID, page=1, page_size=20) if goods_data: print(f"共获取到 {goods_data['total']} 个商品") print("前3个商品信息：") for idx, goods in enumerate(goods_data["goods"][:3]): print(f"{idx+1}. 商品ID：{goods['item_id']}，标题：{goods['title']}，价格：{goods['price']}元")

3. 代码关键说明

• get_weidian_access_token：用于获取接口调用凭证access_token，实际开发中需根据微店开放平台的授权模式调整（如授权码模式需用户授权）；
• get_weidian_goods_list：核心函数，封装了商品列表 API 的请求逻辑，包含参数校验、异常处理、响应解析；
• 异常处理：捕获了网络请求异常、响应字段缺失等常见问题，避免程序崩溃；
• 核心参数：method固定为weidian.item.list.get，status=1表示只获取上架商品，可根据需求调整。

四、结语

微店商品列表 API 是对接微店商品数据的基础接口，使用时需注意以下几点：

1. access_token有有效期，建议在代码中增加「token 过期自动重新获取」的逻辑；
2. 接口调用有频率限制，需合理控制请求频率（如分页获取大量商品时增加延时）；
3. 生产环境中，建议将appkey、appsecret等敏感信息存储在环境变量中，而非硬编码；
4. 若需要更精细的商品筛选（如按分类、价格区间），可参考微店开放平台官方文档扩展请求参数。

总结

1. 调用微店商品列表 API 的核心前提：获取开发者账号、应用授权、有效access_token；
2. Python 调用核心步骤：获取access_token→ 构造请求参数 → 调用 API → 解析响应；
3. 关键注意事项：处理access_token过期、控制调用频率、做好异常处理。