?

對(duì)于在拼多多平臺(tái)上運(yùn)營(yíng)店鋪的商家或開發(fā)者而言，高效地管理和分析店鋪商品至關(guān)重要。拼多多開放平臺(tái)提供了豐富的API接口，其中商品API模塊就包含了獲取店鋪商品列表的功能。本文將詳細(xì)介紹如何調(diào)用此API接口。

一、接口概述

接口名稱：商品列表查詢接口（具體名稱請(qǐng)以官方最新文檔為準(zhǔn)，例如 pdd.goods.list.get）。

功能描述：用于查詢店鋪下所有商品的列表信息（包括已上架、待審核、已下架等狀態(tài)）。

請(qǐng)求方式：通常為 HTTP POST。

請(qǐng)求地址：https://api.pinduoduo.com/router (此為示例，實(shí)際地址請(qǐng)參考官方文檔)。

是否需要授權(quán)：是，需要OAuth 2.0的 access_token。

二、調(diào)用前準(zhǔn)備

成為開發(fā)者：在拼多多開放平臺(tái)注冊(cè)成為開發(fā)者，創(chuàng)建應(yīng)用。

獲取應(yīng)用密鑰：創(chuàng)建應(yīng)用后，獲得 client_id (應(yīng)用標(biāo)識(shí)) 和 client_secret (應(yīng)用密鑰)。

店鋪授權(quán)：引導(dǎo)店鋪主通過(guò)OAuth 2.0授權(quán)流程授權(quán)你的應(yīng)用訪問(wèn)其店鋪數(shù)據(jù)。授權(quán)成功后，你會(huì)獲得該店鋪的 access_token（訪問(wèn)令牌）和 refresh_token（刷新令牌）。access_token 是調(diào)用商品列表接口的憑證，通常有效期為24小時(shí)。

三、請(qǐng)求參數(shù)詳解

調(diào)用商品列表接口通常需要傳遞以下關(guān)鍵參數(shù)：

type：固定值，表示要調(diào)用的API方法名（如 pdd.goods.list.get）。

client_id：你的應(yīng)用ID。

access_token：通過(guò)授權(quán)流程獲取到的店鋪訪問(wèn)令牌。

timestamp：請(qǐng)求發(fā)起時(shí)的13位時(shí)間戳（毫秒）。

data_type：響應(yīng)數(shù)據(jù)格式，通常為 JSON。

version：API版本號(hào)（如 V1）。

page：查詢的頁(yè)碼（從1開始）。

page_size：每頁(yè)返回的商品數(shù)量（最大值通常有限制，如100）。

(可選) goods_status：商品狀態(tài)篩選（如 1-已上架， 2-待審核， 3-已下架等）。

(可選) outer_id：商品外部編碼（商家編碼）。

(可選) goods_name：商品名稱關(guān)鍵字模糊搜索。

(可選) order_by：排序字段（如 create_time-創(chuàng)建時(shí)間， sold_quantity-銷量等）。

(可選) sort_by：排序方式（DESC-倒序， ASC-正序）。

sign：重要！請(qǐng)求簽名。使用 client_secret 和所有請(qǐng)求參數(shù)（按特定規(guī)則排序并拼接）生成的簽名，用于驗(yàn)證請(qǐng)求合法性。簽名算法通常是 MD5 或 HMAC-SHA256。

四、簽名生成（示例 - 概念）

簽名是保證請(qǐng)求安全的關(guān)鍵步驟。偽代碼邏輯如下：

# 1. 獲取所有請(qǐng)求參數(shù)（不包括 sign 本身），剔除空值參數(shù)
params = {k: v for k, v in request_params.items() if v is not None and k != 'sign'}

# 2. 將參數(shù)按鍵名升序排序
sorted_params = sorted(params.items(), key=lambda x: x[0])

# 3. 拼接鍵值對(duì) (key + value)
concatenated_str = ''.join([k + str(v) for k, v in sorted_params])

# 4. 在拼接好的字符串前后加上 client_secret
sign_str = client_secret + concatenated_str + client_secret

# 5. 計(jì)算摘要（如 MD5）
import hashlib
sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()  # 示例用MD5，實(shí)際可能用其他算法

注意：務(wù)必嚴(yán)格按照官方文檔描述的簽名算法和步驟執(zhí)行。

五、請(qǐng)求示例 (Python 偽代碼)

import requests
import time
import hashlib

# 替換為你的實(shí)際信息
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
access_token = "YOUR_ACCESS_TOKEN"
shop_id = "YOUR_SHOP_ID"  # 可能在某些接口需要

# 基礎(chǔ)參數(shù)
api_url = "https://api.pinduoduo.com/router"
api_method = "pdd.goods.list.get"
timestamp = str(int(time.time() * 1000))  # 13位毫秒時(shí)間戳
data_type = "JSON"
version = "V1"
page = 1
page_size = 100  # 假設(shè)最大100

# 構(gòu)建基礎(chǔ)請(qǐng)求參數(shù)字典 (不含 sign)
base_params = {
    "type": api_method,
    "client_id": client_id,
    "access_token": access_token,
    "timestamp": timestamp,
    "data_type": data_type,
    "version": version,
    "page": page,
    "page_size": page_size
}

# 生成簽名 (假設(shè)官方要求 MD5 簽名)
# ... 這里實(shí)現(xiàn)上述的簽名邏輯，得到 sign_value ...
sign_value = generate_sign(base_params, client_secret)  # 假設(shè)的函數(shù)

# 添加簽名到請(qǐng)求參數(shù)
base_params["sign"] = sign_value

# 發(fā)送 POST 請(qǐng)求
response = requests.post(api_url, data=base_params)

# 處理響應(yīng)
if response.status_code == 200:
    data = response.json()
    # 解析 data 中的商品列表和分頁(yè)信息
    goods_list = data.get("goods_list", [])
    total_count = data.get("total_count", 0)
    # ... 處理商品數(shù)據(jù) ...
else:
    print(f"請(qǐng)求失敗，狀態(tài)碼：{response.status_code}, 響應(yīng)：{response.text}")

六、響應(yīng)數(shù)據(jù)結(jié)構(gòu)（示例）

成功的響應(yīng)通常包含以下關(guān)鍵信息：

{
  "code": 0, // 0 表示成功，非0為錯(cuò)誤碼
  "msg": "Success", // 成功或錯(cuò)誤信息
  "result": {
    "goods_list": [ // 商品列表數(shù)組
      {
        "goods_id": 1234567890, // 商品ID
        "goods_name": "示例商品名稱", // 商品名稱
        "goods_image_url": "https://...", // 商品主圖
        "market_price": 10000, // 市場(chǎng)價(jià) (單位：分)
        "group_price": 9900, // 拼團(tuán)價(jià) (單位：分)
        "sold_quantity": 999, // 銷量
        "goods_status": 1, // 商品狀態(tài) (1:已上架, ...)
        "outer_id": "SKU123", // 商家外部編碼
        "create_time": 1672531200000, // 創(chuàng)建時(shí)間 (毫秒時(shí)間戳)
        "update_time": 1672531200000 // 更新時(shí)間 (毫秒時(shí)間戳)
        // ... 其他可能字段 ...
      },
      // ... 更多商品 ...
    ],
    "total_count": 150, // 符合條件的商品總數(shù)
    "current_page": 1, // 當(dāng)前頁(yè)碼
    "page_size": 100 // 每頁(yè)數(shù)量
  }
}

七、分頁(yè)處理

由于店鋪商品數(shù)量可能很多，接口通常采用分頁(yè)返回。開發(fā)者需要：

在請(qǐng)求中指定 page 和 page_size。

在響應(yīng)中獲取 total_count（總商品數(shù)）和 current_page（當(dāng)前頁(yè)）。

計(jì)算總頁(yè)數(shù)：total_pages = (total_count + page_size - 1) // page_size (向上取整)。

循環(huán)請(qǐng)求，從 page=1 開始，直到 page > total_pages 或 current_page * page_size >= total_count（或根據(jù)響應(yīng)是否有下一頁(yè)標(biāo)識(shí)）為止。

八、注意事項(xiàng)

官方文檔：一切以拼多多開放平臺(tái)官方文檔為準(zhǔn)，接口名稱、參數(shù)、簽名算法、返回字段可能更新。

權(quán)限范圍：確保你的應(yīng)用申請(qǐng)了獲取商品列表所需的API權(quán)限。

access_token 有效期：access_token 會(huì)過(guò)期，需通過(guò) refresh_token 刷新。接口調(diào)用失敗時(shí)，注意檢查 access_token 是否失效。

請(qǐng)求頻率限制：拼多多API通常有嚴(yán)格的調(diào)用頻率限制（QPS），超出限制會(huì)被限流或封禁。合理設(shè)計(jì)調(diào)用策略，必要時(shí)使用緩存。

錯(cuò)誤處理：仔細(xì)處理各種錯(cuò)誤碼（如令牌失效、參數(shù)錯(cuò)誤、頻率超限、系統(tǒng)錯(cuò)誤等）。

HTTPS：務(wù)必使用HTTPS協(xié)議調(diào)用接口。

敏感信息：妥善保管 client_secret 和 access_token，不要泄露。

商業(yè)用途：如需用于商業(yè)環(huán)境，確保遵守拼多多平臺(tái)規(guī)則和法律法規(guī)。

九、總結(jié)

通過(guò)調(diào)用拼多多開放平臺(tái)的商品列表查詢接口，開發(fā)者可以高效地批量獲取店鋪商品數(shù)據(jù)，為商品管理、數(shù)據(jù)分析、庫(kù)存同步等應(yīng)用場(chǎng)景提供強(qiáng)大的技術(shù)支持。關(guān)鍵在于理解授權(quán)流程、掌握簽名算法、正確處理分頁(yè)以及遵守平臺(tái)調(diào)用規(guī)范。希望本文能幫助開發(fā)者快速上手這一功能。

再次強(qiáng)調(diào)：本文基于對(duì)電商平臺(tái)API通用模式的認(rèn)知撰寫，具體實(shí)現(xiàn)細(xì)節(jié)請(qǐng)務(wù)必以拼多多開放平臺(tái)最新、官方的API文檔和技術(shù)規(guī)范為準(zhǔn)。

?審核編輯 黃宇