一、接口概述
微店商品详情接口(/item/get)提供商品基础信息、SKU数据、库存价格等核心数据获取能力,采用RESTful风格,返回JSON格式数据。
二、前期准备 创建微店开放平台应用 获取API权限:商品读取权限(weidian.item.get) 准备认证参数:AppKey、AppSecret、AccessToken
点击获取key和secret
三、接口调用代码实现
python
Copy Code
import requests
import hashlib
import time
def get_item_detail(item_id): # 基础配置 app_key = "YOUR_APP_KEY" app_secret = "YOUR_APP_SECRET" access_token = "YOUR_ACCESS_TOKEN"
# 构造请求参数
params = {
"access_token": access_token,
"item_id": str(item_id),
"format": "json",
"v": "1.0",
"timestamp": str(int(time.time())),
"sign_method": "md5"
}
# 生成签名
param_str = "".join([f"{k}{v}" for k,v in sorted(params.items())])
sign_str = app_secret + param_str + app_secret
params["sign"] = hashlib.md5(sign_str.encode()).hexdigest().upper()
# 发送请求
url = "https://api.weidian.com/item/get"
response = requests.get(url, params=params)
# 处理响应
if response.status_code == 200:
result = response.json()
if result.get("status")["status_code"] == 0:
return result["result"]
else:
raise Exception(f"接口错误: {result['status']['status_reason']}")
else:
response.raise_for_status()
调用示例
item_data = get_item_detail("12345678") print(f"商品标题:{item_data['title']}") print(f"当前价格:{item_data['price']}元") print(f"可用库存:{item_data['stock']}件")
四、响应数据结构示例 json Copy Code { "status": { "status_code": 0, "status_reason": "success" }, "result": { "item_id": "12345678", "title": "智能温控咖啡杯", "price": "199.00", "original_price": "299.00", "stock": 1500, "sku_list": [ { "sku_id": "1001", "specs": "黑色/350ml", "price": "199.00", "stock": 800 } ], "main_imgs": ["img.example.com/1.jpg"], "detail_html": "