一、官方 API 接入核心信息
1. 接入前提
- 注册并入驻得物开放平台（https://open.dewu.com/），完成企业认证与应用创建
- 申请
商品详情查询等接口权限，获取appKey、appSecret与access_token（接口调用需签名验证） - 遵守得物 API 使用规范，不得用于爬虫、未授权商用等违规场景
2. 核心接口说明（官方推荐）
| 接口名称 | 接口地址 | 核心参数 | 返回字段 | 适用场景 |
|---|---|---|---|---|
| 商品详情查询 | https://open.dewu.com/api/v1/product/detail | productId（商品 ID）、skuId（可选） | 商品标题、价格、SKU 列表、库存、详情图、属性、商家信息 | 获取完整商品详情 |
| 商品 SKU 查询 | https://open.dewu.com/api/v1/product/sku | productId | SKU ID、规格、价格、库存、图片 | 单独获取 SKU 数据 |
| 商品价格查询 | https://open.dewu.com/api/v1/product/price | productId、skuId | 原价、现价、折扣、活动价 | 实时获取价格 |
3. 调用流程与签名规则
- 获取 access_token（通过
/oauth2/token接口，使用 appKey 与 appSecret 换取，有效期 2 小时）http
POST /oauth2/token HTTP/1.1 Host: open.dewu.com Content-Type: application/x-www-form-urlencoded grant_type=client_credentials&client_id=YOUR_APP_KEY&client_secret=YOUR_APP_SECRET - 接口调用示例（以商品详情查询为例）
http
GET /api/v1/product/detail?productId=123456 HTTP/1.1 Host: open.dewu.com Authorization: Bearer YOUR_ACCESS_TOKEN Content-Type: application/json - 签名验证（部分接口需按得物规范生成签名，参数含
timestamp、nonce、appKey等，用 appSecret 加密）
二、接口返回示例（JSON 结构）
json
{ "code": 200, "message": "success", "data": { "productId": "123456", "title": "Air Jordan 1 Retro High OG 黑红脚趾", "originalPrice": 1299, "currentPrice": 2499, "saleStatus": 1, // 1=在售，0=下架 "skuList": [ { "skuId": "789012", "size": "42", "price": 2499, "stock": 5, "image": "https://img.dewu.com/product/xxx.jpg" } ], "detailImages": ["https://img.dewu.com/detail/xxx.jpg"], "desc": "商品详情描述...", "brand": "Nike", "categoryId": 1001 // 品类ID } }三、非官方方案（合规风险提示）
- 不建议直接爬虫：得物有反爬机制（IP 封禁、请求频率限制、验证码），且未经授权爬取商品数据可能违反《网络安全法》与平台协议
- 替代方案
- 若仅需少量数据，可通过得物 App 的
分享链接解析（需手动处理，不适合批量） - 第三方数据服务商（如数据宝、聚合数据）可能提供得物商品数据 API（需确认合规性）
- 若仅需少量数据，可通过得物 App 的
四、接入注意事项
- 权限与限流：官方 API 有调用频率限制（如 100 次 / 分钟），需合理设计请求逻辑，避免触发限流
- 数据更新：商品价格、库存等实时数据建议通过定时调用接口同步，或订阅得物的
商品状态变更回调 - 错误处理：接口返回
401（token 失效）需重新获取，429（限流）需延时重试，500（服务器错误）需记录并告警
五、快速接入步骤
- 访问得物开放平台完成入驻与应用创建
- 申请商品详情接口权限，获取
appKey与appSecret - 开发签名与 token 获取逻辑，编写接口调用代码
- 解析返回的 JSON 数据，提取所需字段（如商品标题、价格、SKU 等）
