dewu

A lightweight proxy for the DeWu (poizon) product API.

原始信息汇总

数据集详情总结：dewu

基本信息

• 名称：dewu
• 类别：eCommerce（电子商务）
• 创建者：m505umumomo
• 订阅人数：1
• 服务等级：100%
• 延迟：5107ms
• 流行度：9

API 描述

提供对 DeWu（得物 / Poizon） 产品 API 的轻量级代理。DeWu 是中国领先的球鞋和生活方式市场。该 API 允许用户通过货号查询商品、获取完整产品详情、实时 SKU 价格、近期交易记录和价格历史趋势。

主机与协议

• 主机：https://dewu2.p.rapidapi.com
• 协议：HTTPS · POST
• 响应格式：JSON
• 认证方式：API Key（通过请求头传递）

端点列表

方法	路径	参数	返回内容
POST	/product/list	key（货号）	匹配商品数组
POST	/product/detail	spuId	完整产品记录
POST	/product/price	spuId	SKU 价格数组
POST	/product/lastSold	spuId	近期交易记录数组
POST	/product/priceTrend	spuId	价格历史数据点数组

响应格式

所有响应均使用统一结构，HTTP 状态码始终为 200，业务结果通过 code 字段判断：

• code: 200 — 成功
• code: 404 — 未找到
• code: 500 — 错误/繁忙/数据准备中，可重试

产品详情响应结构

产品详情端点返回两种形状的数据：

1. 单变体产品：返回顶层 images（图片数组）和 sizes（尺码数组）。
2. 多变体产品（多种配色）：返回 specs 数组，每个规格包含独立的 images、skus、specName 和 propertyValueId。

缓存与刷新机制

• /price、/lastSold、/priceTrend 端点提供的数据最多有 10 分钟 的新鲜度窗口。
• 当数据过期或缺失时，API 会自动触发异步抓取。
• 在数据准备期间，可能返回 code: 500 和消息 "data preparing, try again later"，建议等待 10-20 秒后重试。

最佳实践

• 本地缓存 spuId，并在 /detail、/price、/lastSold、/priceTrend 中复用，减少调用次数。
• 所有参数通过查询参数传递。