接口概述
通过商品详情API可获取唯品会平台指定商品的详细信息，包括标题、价格、库存、规格参数、图文详情等数据。
接口地址（示例）：
text Copy Code api.vip.com/item/detail
请求方式：GET/POST
请求参数 参数名 类型 必填 说明 app_key string 是 开放平台分配的AppKey item_id string 是 商品唯一标识ID（例：32567823） timestamp int 是 请求时间戳（防重放） sign string 是 请求签名（加密算法见下文） 签名生成算法 python Copy Code import hashlib
def generate_sign(params, app_secret): sorted_params = sorted(params.items()) param_str = '&'.join([f"{k}={v}" for k, v in sorted_params]) sign = hashlib.md5(f"{param_str}{app_secret}".encode()).hexdigest().upper() return sign
响应示例（JSON） json Copy Code { "code": 200, "data": { "item_id": "32567823", "title": "【2024新款】春季男士休闲商务衬衫", "price": 259.00, "original_price": 599.00, "brand": "七匹狼", "specs": [ { "color": "浅蓝色", "size": ["S", "M", "L"], "stock": 150 } ], "main_images": [ "img.vip.com/2024/.../1.…", "img.vip.com/2024/.../2.…" ], "detail_html": "
Python接入示例 python Copy Code import requests import time import hashlib
def get_item_detail(item_id): base_url = "api.vip.com/item/detail" app_key = "YOUR_APP_KEY" app_secret = "YOUR_APP_SECRET"
params = {
"app_key": app_key,
"item_id": item_id,
"timestamp": int(time.time())
}
# 生成签名
sign = generate_sign(params, app_secret)
params["sign"] = sign
try:
response = requests.get(base_url, params=params)
response.raise_for_status()
return response.json()
except requests.exceptions.RequestException as e:
print(f"API请求失败：{str(e)}")
return None
调用示例
item_data = get_item_detail("32567823") if item_data and item_data["code"] == 200: print(f"商品标题：{item_data['data']['title']}") print(f"当前价格：{item_data['data']['price']}")
注意事项 需提前申请开放平台权限，获取AppKey和AppSecret 接口调用频率限制：默认100次/分钟 商品ID可通过商品搜索接口或店铺页面获取 注意处理常见错误码： 4001：签名验证失败 4004：商品不存在 5001：系统繁忙
