一、官方 API 接入核心信息

1. 接入前提

注冊(cè)并入駐得物開放平臺(tái)（https://open.dewu.com/），完成企業(yè)認(rèn)證與應(yīng)用創(chuàng)建

申請(qǐng)商品詳情查詢等接口權(quán)限，獲取appKey、appSecret與access_token（接口調(diào)用需簽名驗(yàn)證）

遵守得物 API 使用規(guī)范，不得用于爬蟲、未授權(quán)商用等違規(guī)場(chǎng)景

2. 核心接口說(shuō)明（官方推薦）

3. 調(diào)用流程與簽名規(guī)則

獲取 access_token（通過(guò)/oauth2/token接口，使用 appKey 與 appSecret 換取，有效期 2 小時(shí)）

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

接口調(diào)用示例（以商品詳情查詢?yōu)槔?/p>

http

GET /api/v1/product/detail?productId=123456 HTTP/1.1
Host: open.dewu.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

簽名驗(yàn)證（部分接口需按得物規(guī)范生成簽名，參數(shù)含timestamp、nonce、appKey等，用 appSecret 加密）

二、接口返回示例（JSON 結(jié)構(gòu)）

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
  }
}

三、非官方方案（合規(guī)風(fēng)險(xiǎn)提示）

不建議直接爬蟲：得物有反爬機(jī)制（IP 封禁、請(qǐng)求頻率限制、驗(yàn)證碼），且未經(jīng)授權(quán)爬取商品數(shù)據(jù)可能違反《網(wǎng)絡(luò)安全法》與平臺(tái)協(xié)議

替代方案

若僅需少量數(shù)據(jù)，可通過(guò)得物 App 的分享鏈接解析（需手動(dòng)處理，不適合批量）

第三方數(shù)據(jù)服務(wù)商（如數(shù)據(jù)寶、聚合數(shù)據(jù)）可能提供得物商品數(shù)據(jù) API（需確認(rèn)合規(guī)性）

四、接入注意事項(xiàng)

權(quán)限與限流：官方 API 有調(diào)用頻率限制（如 100 次 / 分鐘），需合理設(shè)計(jì)請(qǐng)求邏輯，避免觸發(fā)限流

數(shù)據(jù)更新：商品價(jià)格、庫(kù)存等實(shí)時(shí)數(shù)據(jù)建議通過(guò)定時(shí)調(diào)用接口同步，或訂閱得物的商品狀態(tài)變更回調(diào)

錯(cuò)誤處理：接口返回401（token 失效）需重新獲取，429（限流）需延時(shí)重試，500（服務(wù)器錯(cuò)誤）需記錄并告警

五、快速接入步驟

訪問(wèn)得物開放平臺(tái)完成入駐與應(yīng)用創(chuàng)建

申請(qǐng)商品詳情接口權(quán)限，獲取appKey與appSecret

開發(fā)簽名與 token 獲取邏輯，編寫接口調(diào)用代碼

解析返回的 JSON 數(shù)據(jù)，提取所需字段（如商品標(biāo)題、價(jià)格、SKU 等）

審核編輯 黃宇