解析得物商品详情：API 接口调用实践与数据结构分析

​

得物平台（原毒APP）作为国内领先的潮流电商平台，其商品数据具有很高的价值。对于开发者而言，了解如何通过其提供的 API 接口获取商品详情信息，是进行数据分析、比价工具开发、库存监控等应用的基础。本文将聚焦于得物平台的商品详情 API 接口，探讨其调用方式、核心参数及返回的数据结构。

1. 接口概览与请求方式

接口功能：获取指定商品的详细信息，包括基础信息（名称、品牌、分类）、价格、库存状态、规格参数、图片、描述等。

请求方式：通常为 HTTP GET 请求。

接口地址：一般为平台API服务域名下的特定路径，例如 https://api.dewu.com/product/detail (实际地址需以官方文档为准)。

认证：部分接口可能需要 API Key、Access Token 或其他形式的认证信息，通常在请求头（如 Authorization）中传递。

2. 核心请求参数

调用商品详情接口，最关键的参数是能够唯一标识目标商品的参数：

商品ID (productId)：这是最常用且最稳定的标识符。每个在得物平台上架的商品都会有一个唯一的数字ID。

示例请求：

GET /product/detail?productId=123456789

商品SKU ID (skuId)：部分接口可能支持通过具体的商品SKU ID来查询，适用于需要精确到特定颜色、尺码等规格的场景。

示例请求：

GET /product/detail?skuId=987654321

3. 响应数据结构解析 (JSON 格式示例)

成功的 API 调用会返回一个结构化的 JSON 对象。以下是一个简化的核心字段示例及其含义：

{
  "code": 200, // 状态码，200 通常表示成功
  "msg": "success", // 状态信息
  "data": {
    "productId": 123456789, // 商品唯一ID
    "productName": "Air Jordan 1 Retro High OG 'University Blue'", // 商品名称
    "brandId": 1001, // 品牌ID
    "brandName": "Jordan", // 品牌名称
    "categoryId": 2001, // 分类ID
    "categoryName": "运动鞋", // 分类名称
    "mainImage": "https://img.dewu.com/path/to/image.jpg", // 商品主图URL
    "price": 1599.00, // 当前销售价格 (单位：元)
    "originalPrice": 1799.00, // 原始标价 (单位：元)
    "stockStatus": 1, // 库存状态 (1-有货, 0-缺货等，具体值需参考文档)
    "description": "经典大学蓝配色...", // 商品描述文本 (可能含HTML)
    "specs": [ // 商品规格列表
      {
        "specId": "color", // 规格类型ID
        "specName": "颜色", // 规格类型名称
        "specValue": "University Blue/White" // 规格值
      },
      {
        "specId": "size",
        "specName": "尺码",
        "specValue": "42.5"
      }
    ],
    "imageList": [ // 商品图片列表
      "https://img.dewu.com/path/to/image1.jpg",
      "https://img.dewu.com/path/to/image2.jpg"
    ],
    "skus": [ // 商品SKU列表 (不同规格组合)
      {
        "skuId": 987654321, // SKU唯一ID
        "specCombination": "University Blue/White-42.5", // 规格组合描述
        "price": 1599.00,
        "stockStatus": 1
      },
      // ... 其他SKU
    ]
  }
}

关键字段说明

productId, skuId: 是后续进行其他操作（如加购、下单）的关键标识。

price, originalPrice: 用于价格展示和折扣计算。

stockStatus: 实时库存状态至关重要，尤其在抢购或监控场景。

specs: 提供了商品的具体属性信息。

skus: 对于多规格商品，此数组列出了所有可选的规格组合及其对应的价格和库存。

4. 调用实践与注意事项

获取 productId 或 skuId：通常可以通过得物App的商品详情页URL、或通过搜索API的结果列表中获取。

请求频率限制：平台API通常会有调用频率限制（Rate Limit），需合理控制请求节奏，避免触发限制被封禁。

错误处理：务必检查返回的 code 字段。非 200 状态码表示请求失败，需根据 msg 或具体错误码进行问题排查（如参数错误、认证失败、商品不存在等）。

数据解析：返回的 description 字段可能包含HTML标签，需要做相应的清理或转换才能用于纯文本展示。imageList 中的URL可能需要拼接完整的图片访问地址。

API稳定性：第三方开发者需注意，平台API可能会进行更新或调整，接口地址、参数、返回字段都可能发生变化。建议定期关注官方文档（如有公开）或做好兼容性处理。

合规性：调用API需遵守得物平台的相关规定，不得用于爬取大量数据、干扰平台正常运营等违规用途。尊重平台的数据权益。

5. 示例代码 (Python)

import requests

# 假设的API地址和商品ID (实际使用时需替换为有效值)
api_url = "https://api.dewu.com/product/detail"
product_id = "123456789"  # 或使用 skuId

# 构造请求参数
params = {
    "productId": product_id
}
# 如果需要认证，添加请求头 headers
# headers = {"Authorization": "Bearer your_access_token"}

try:
    # 发送GET请求
    response = requests.get(api_url, params=params) # , headers=headers
    response.raise_for_status()  # 检查HTTP错误

    # 解析JSON响应
    data = response.json()

    # 检查API状态码
    if data.get("code") == 200:
        product_data = data["data"]
        print(f"商品名称: {product_data['productName']}")
        print(f"当前价格: ¥{product_data['price']:.2f}")
        print(f"库存状态: {'有货' if product_data['stockStatus'] == 1 else '缺货'}")
        # ... 进一步处理其他数据
    else:
        print(f"API请求失败: {data.get('msg')}")

except requests.exceptions.RequestException as e:
    print(f"网络请求错误: {e}")
except ValueError as e:
    print(f"JSON解析错误: {e}")

总结

得物平台的商品详情 API 为开发者提供了获取商品核心信息的有效途径。理解其请求参数、响应数据结构以及调用时的注意事项，是成功集成该功能的关键。开发者应始终关注接口的合规使用，并做好应对接口变更的准备。通过有效利用这些数据，可以构建出丰富的电商相关应用和服务。

​

审核编辑 黄宇