2025年微店平台商品详情接口调用指南(Python代码示例)

102 阅读1分钟

一、接口概述

微店商品详情接口(/item/get)提供商品基础信息、SKU数据、库存价格等核心数据获取能力,采用RESTful风格,返回JSON格式数据。

二、前期准备 创建微店开放平台应用 获取API权限:商品读取权限(weidian.item.get) 准备认证参数:AppKey、AppSecret、AccessToken

图片.png 点击获取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": "

商品详情内容...
" } }