唯品会商品详情接口开发指南

接口功能说明

唯品会开放平台提供了商品详情查询接口,开发者可通过商品ID获取商品的标题、价格、库存、主图等核心信息。该接口采用RESTful风格,返回数据格式为JSON。

接口请求参数

参数名类型是否必填说明goods_idstring是商品唯一标识keystring是开发者密钥timestampint是当前时间戳

点击获取key和secret

Python调用示例

复制代码
import requests
import hashlib
import time

def get_vip_product_detail(goods_id):
    api_url = "https://api.vip.com/product/detail"
    app_key = "YOUR_APP_KEY"
    secret = "YOUR_SECRET"
    timestamp = int(time.time())
    
    # 生成签名
    sign_str = f"goods_id={goods_id}&key={app_key}&timestamp={timestamp}{secret}"
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    params = {
        "goods_id": goods_id,
        "key": app_key,
        "timestamp": timestamp,
        "sign": sign
    }
    
    try:
        response = requests.get(api_url, params=params)
        if response.status_code == 200:
            data = response.json()
            if data["code"] == 200:
                return {
                    "title": data["result"]["goods_name"],
                    "price": data["result"]["vip_price"],
                    "stock": data["result"]["stock"],
                    "main_image": data["result"]["main_image"]
                }
        return None
    except Exception as e:
        print(f"接口请求异常: {e}")
        return None

# 调用示例
product_info = get_vip_product_detail("12345678")
print(product_info)

返回数据结构

复制代码
{
    "code": 200,
    "message": "success",
    "result": {
        "goods_id": "12345678",
        "goods_name": "2025新款夏季男士T恤",
        "vip_price": 129.00,
        "market_price": 299.00,
        "stock": 100,
        "main_image": "https://img.vip.com/xxx.jpg",
        "sales": 3568
    }
}

注意事项

  1. 需提前在唯品会开放平台申请开发者账号

  2. 接口有QPS限制(默认100次/秒)

  3. 敏感参数建议加密传输

  4. 生产环境需要添加异常重试机制