当前位置：首页 > news >正文

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

news 2025/7/3 21:57:05

一、接口概述

微店商品详情接口（/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": ["https://img.example.com/1.jpg"],
    "detail_html": "<div>商品详情内容...</div>"
}
}