一、官方 API 接入核心信息

1. 接入前提

注冊并入駐得物開放平臺（https://open.dewu.com/），完成企業認證與應用創建

申請商品詳情查詢等接口權限，獲取appKey、appSecret與access_token（接口調用需簽名驗證）

遵守得物 API 使用規范，不得用于爬蟲、未授權商用等違規場景

2. 核心接口說明（官方推薦）

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 等）

審核編輯 黃宇