唯品会商品详情API接口通常返回结构化的JSON数据，包含商品核心信息、价格库存、多媒体资源等关键字段，以下是详细说明及示例：

一、核心数据结构

1. 基础响应结构
   所有接口响应包含公共字段，用于标识请求状态：

   json{"code": 200,          // 状态码（200表示成功）"message": "success",  // 状态描述"data": {              // 核心业务数据// 商品详情字段（见下文）}}

2. 商品详情核心字段

• 商品基本信息

  json{"product_id": "123456789",  // 商品唯一ID"title": "夏季纯棉T恤",      // 商品标题"brand": "XX品牌",          // 品牌名称"category": "男装/上衣/T恤", // 商品分类路径"desc_short": "纯棉材质,透气舒适", // 简短描述"detail_url": "https://detail.vip.com/xxx.html" // 商品详情页链接}

• 价格与库存

  json{"price": "99.00",            // 当前售价（字符串类型，避免精度丢失）"market_price": "199.00",    // 市场价（原价）"stock": 500,                // 当前库存数量"sale_stock_status": 1,      // 库存状态（1=有货，2=无货）"sales_count": 1200          // 累计销量}

• 图片与多媒体

  json{"images": [                  // 商品图片列表（主图+轮播图）"https://img.vip.com/123.jpg","https://img.vip.com/456.jpg"],"pic_url": "https://img.vip.com/main.jpg", // 商品主图"video": "https://video.vip.com/xxx.mp4"  // 商品视频（如有）}

• 商品属性

  json{"attributes": {              // 商品规格属性（如颜色、尺码）"color": ["白色", "黑色"],"size": ["S", "M", "L"]},"specifications": {          // 详细规格参数"材质": "纯棉","版型": "修身"}}

• 时间信息

  json{"created_time": 1537845115000,  // 商品上架时间（Unix时间戳，毫秒级）"modified_time": 1683886534000 // 商品最后更新时间}

二、完整示例

json{"code": 200,"message": "success","data": {"product_id": "123456789","title": "夏季纯棉T恤","brand": "XX品牌","category": "男装/上衣/T恤","price": "99.00","market_price": "199.00","stock": 500,"sales_count": 1200,"images": ["https://img.vip.com/123.jpg","https://img.vip.com/456.jpg"],"attributes": {"color": ["白色", "黑色"],"size": ["S", "M", "L"]},"created_time": 1537845115000}}

三、关键点说明

1. 状态码与错误处理

• code=200 表示请求成功，其他值（如 400、500）需结合 message 字段排查问题。

2. 数据嵌套结构

• 复杂数据（如图片、属性）以嵌套 JSON 对象或数组形式返回，需逐层解析。

3. 时间戳格式

• 时间字段通常为 Unix 时间戳（毫秒级），需转换为可读格式（如 datetime.fromtimestamp(1537845115000/1000)）。

4. 字段扩展性

• 实际接口可能包含更多字段（如促销信息、物流规则），需参考唯品会官方文档。

四、应用场景

1. 电商数据分析

• 提取价格、销量、分类等数据，分析市场趋势。

2. 竞品监控

• 对比同类商品的价格、库存变化，优化定价策略。

3. 应用开发

• 在 APP 或网站中展示商品详情，提升用户体验。

4. 价格预警

• 实时监控商品价格，触发降价通知。