唯品会商品详情API接口返回数据是怎样的？

用户268001379192025-07-28 16:12

唯品会商品详情API接口返回的数据通常采用JSON格式，结构清晰且包含商品的多维度信息，以下是返回数据的主要结构及说明：

一、基础响应结构

所有接口响应均包含公共字段，用于标识请求状态：

json 复制代码

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

二、商品详情核心字段

1. 商品基本信息

json 复制代码

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

2. 价格与库存

json 复制代码

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

3. 图片与多媒体

json 复制代码

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"   // 商品视频（如有）
}

4. 商品属性

json 复制代码

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

5. 时间信息

json 复制代码

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

三、完整示例

css 复制代码

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
  }
}

四、应用场景

电商数据分析：提取价格、销量、分类等数据，分析市场趋势。
竞品监控：对比同类商品的价格、库存变化，优化定价策略。
应用开发：在APP或网站中展示商品详情，提升用户体验。
价格预警：实时监控商品价格，触发降价通知。