微店商品详情API接口使用指南（JSON数据返回）

一、注册与权限获取

1. 账号注册

• 访问微店开放平台，使用微店账号登录（若无账号需先注册）。

• 完成实名认证（个人或企业），企业账号需提交营业执照，审核时间1-3个工作日。

2. 创建应用

• 应用名称：如“微店商品分析工具”。

• 应用类型：选择“服务端应用”。

• 回调地址：若需OAuth授权，填写HTTPS回调URL（如https://yourdomain.com/callback）。

• 进入“控制台 > 应用管理 > 创建应用”。

• 填写信息：

• 提交审核，通常1个工作日内通过。

3. 申请API权限

• vdian.item.get（获取单个商品详情）。

• vdian.item.list.get（批量获取商品列表）。

• 在应用详情页点击“API权限管理”，申请以下接口：

• 填写使用场景（如“商品数据分析”），等待审核（通常1小时内完成）。

4. 获取凭证

• 审核通过后，在应用详情页查看client_id（App Key）和client_secret（App Secret）。

二、API调用流程

1. 获取Access Token

   python
   import requests
   
   def get_access_token(client_id, client_secret):
   url = "https://api.vdian.com/token"
   params = {
   "client_id": client_id,
   "client_secret": client_secret,
   "grant_type": "client_credentials"
   }
   response = requests.post(url, data=params)
   return response.json().get("result", {}).get("access_token")

2. 调用商品详情接口

   pythondef get_item_detail(access_token, item_id):url = "https://api.vdian.com/api"params = {"method": "vdian.item.get","access_token": access_token,"version": "1.0","format": "json","itemid": item_id  # 商品ID，从微店商品URL提取（如https://weidian.com/item.html?itemid=123456）}response = requests.post(url, data=params)return response.json()

3. 解析JSON响应

   python
   access_token = get_access_token("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")
   item_data = get_item_detail(access_token, "123456")
   
   if item_data.get("status", {}).get("status_code") == 0:
   item = item_data["result"]
   print(f"商品名称: {item['title']}")
   print(f"价格: {item['price']}元")
   print(f"库存: {item['stock']}")
   print(f"描述: {item['item_imgs']}")  # 商品图片URL列表
   else:
   print(f"错误: {item_data.get('status', {}).get('status_reason')}")

三、关键API接口说明

1. 获取单个商品详情

• itemid: 商品ID（从URL提取，如123456）。

• 接口: vdian.item.get

• 必填参数:

• 返回字段:

  json{"status": {"status_code": 0, "status_reason": "success"},"result": {"title": "测试商品","price": "99.00","stock": 100,"item_imgs": ["https://wd.image.com/img1.jpg", "https://wd.image.com/img2.jpg"],"sku": [{"id": "1", "price": "99.00", "stock": 50, "title": "红色"}]}}

2. 批量获取商品列表

• page_num: 页码（默认1）。

• page_size: 每页数量（默认20，最大100）。

• 接口: vdian.item.list.get

• 可选参数:

• 返回字段:

  json{"status": {"status_code": 0},"result": {"items": [{"itemid": "123456", "title": "商品A", "price": "50.00"},{"itemid": "789012", "title": "商品B", "price": "30.00"}],"total": 2}}

四、注意事项

1. 频率限制

• 默认每分钟60次调用，超限返回错误码429。

• 企业用户可申请提高配额（需联系微店商务）。

2. 数据脱敏

• 用户信息（如买家昵称）不会在商品详情中返回，需通过订单接口获取。

3. 错误处理

• status_code=0: 成功。

• status_code=1001: 参数错误（检查itemid格式）。

• status_code=2001: 权限不足（确认API权限已开通）。

4. 字段说明

• item_imgs: 商品图片URL列表，可能需拼接域名（如https://wd.image.com/ + 返回路径）。

• sku: 商品规格列表，包含价格、库存和规格名称。

五、应用场景案例

1. 商品价格监控

• 定时调用vdian.item.get，记录价格变化并生成趋势图表。

2. 库存预警系统

• 批量获取商品列表，当stock低于阈值时发送通知（如邮件/短信）。

3. 多平台比价工具

• 结合淘宝/拼多多API，对比微店商品价格，自动生成比价报告。

总结

微店API通过JSON格式返回数据，结构清晰易解析。重点流程：

1. 获取access_token → 2. 调用商品接口 → 3. 处理JSON响应。
   注意权限申请、频率限制和错误码处理即可高效集成。