得物平台（原毒APP）作为国内领先的潮流电商平台，其商品数据具有很高的价值。对于开发者而言，了解如何通过其提供的 API 接口获取商品详情信息，是进行数据分析、比价工具开发、库存监控等应用的基础。本文将聚焦于得物平台的商品详情 API 接口，探讨其调用方式、核心参数及返回的数据结构。
- 接口概览与请求方式
接口功能：获取指定商品的详细信息，包括基础信息（名称、品牌、分类）、价格、库存状态、规格参数、图片、描述等。
请求方式：通常为 HTTP GET 请求。
接口地址：一般为平台API服务域名下的特定路径，例如 https://api.dewu.com/product/detail (实际地址需以官方文档为准)。
认证：部分接口可能需要 API Key、Access Token 或其他形式的认证信息，通常在请求头（如 Authorization）中传递。 - 核心请求参数
调用商品详情接口，最关键的参数是能够唯一标识目标商品的参数：
商品ID (productId)：这是最常用且最稳定的标识符。每个在得物平台上架的商品都会有一个唯一的数字ID。
示例请求：
GET /product/detail?productId=123456789
商品SKU ID (skuId)：部分接口可能支持通过具体的商品SKU ID来查询，适用于需要精确到特定颜色、尺码等规格的场景。
示例请求：
GET /product/detail?skuId=987654321
- 响应数据结构解析 (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: 对于多规格商品，此数组列出了所有可选的规格组合及其对应的价格和库存。
- 调用实践与注意事项
获取 productId 或 skuId：通常可以通过得物App的商品详情页URL、或通过搜索API的结果列表中获取。
请求频率限制：平台API通常会有调用频率限制（Rate Limit），需合理控制请求节奏，避免触发限制被封禁。
错误处理：务必检查返回的 code 字段。非 200 状态码表示请求失败，需根据 msg 或具体错误码进行问题排查（如参数错误、认证失败、商品不存在等）。
数据解析：返回的 description 字段可能包含HTML标签，需要做相应的清理或转换才能用于纯文本展示。imageList 中的URL可能需要拼接完整的图片访问地址。
API稳定性：第三方开发者需注意，平台API可能会进行更新或调整，接口地址、参数、返回字段都可能发生变化。建议定期关注官方文档（如有公开）或做好兼容性处理。
合规性：调用API需遵守得物平台的相关规定，不得用于爬取大量数据、干扰平台正常运营等违规用途。尊重平台的数据权益。 - 示例代码 (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 为开发者提供了获取商品核心信息的有效途径。理解其请求参数、响应数据结构以及调用时的注意事项，是成功集成该功能的关键。开发者应始终关注接口的合规使用，并做好应对接口变更的准备。通过有效利用这些数据，可以构建出丰富的电商相关应用和服务。
