得物商品详情API

一、官方 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（需确认合规性）

四、接入注意事项

权限与限流：官方 API 有调用频率限制（如 100 次 / 分钟），需合理设计请求逻辑，避免触发限流

数据更新：商品价格、库存等实时数据建议通过定时调用接口同步，或订阅得物的商品状态变更回调

错误处理：接口返回401（token 失效）需重新获取，429（限流）需延时重试，500（服务器错误）需记录并告警

五、快速接入步骤

访问得物开放平台完成入驻与应用创建

申请商品详情接口权限，获取appKey与appSecret

开发签名与 token 获取逻辑，编写接口调用代码

解析返回的 JSON 数据，提取所需字段（如商品标题、价格、SKU 等）

审核编辑 黄宇