?

在電商平臺生態(tài)開發(fā)中，獲取店鋪信息是常見的需求。本文將介紹如何通過拼多多開放平臺的 API 接口獲取店鋪列表，包括接口概述、調(diào)用流程以及注意事項。

1. 接口概述

拼多多開放平臺提供了 pdd.mall.info.list.get (或類似名稱，具體名稱請以官方文檔為準(zhǔn)) 接口用于查詢店鋪列表。開發(fā)者可以通過此接口獲取授權(quán)店鋪的基本信息。

主要功能：

查詢當(dāng)前授權(quán)賬號下的店鋪列表。

獲取店鋪的核心信息，如店鋪 ID、店鋪名稱、店鋪 Logo 等。

2. 調(diào)用流程

調(diào)用拼多多開放平臺 API 獲取店鋪列表通常遵循以下步驟：

2.1 準(zhǔn)備工作

成為開發(fā)者： 在拼多多開放平臺 (https://open.pinduoduo.com) 注冊賬號并完成開發(fā)者認(rèn)證。

創(chuàng)建應(yīng)用： 在開發(fā)者后臺創(chuàng)建應(yīng)用，獲取 client_id (應(yīng)用ID) 和 client_secret (應(yīng)用密鑰)。這些是接口調(diào)用的憑證。

授權(quán)獲取： 引導(dǎo)商家通過 OAuth2.0 授權(quán)流程對你的應(yīng)用進(jìn)行授權(quán)。授權(quán)成功后，你會獲得代表商家身份的 access_token。

2.2 接口調(diào)用

調(diào)用接口需要構(gòu)造一個 HTTP POST 請求，發(fā)送到拼多多的 API 網(wǎng)關(guān)地址。請求中必須包含以下關(guān)鍵信息：

API 地址： 通常為 https://api.pinduoduo.com/router/router (具體地址請參考官方文檔)。

請求參數(shù) (HTTP Body)： 使用 application/x-www-form-urlencoded 格式，包含：

type: 固定值，例如 pdd.mall.info.list.get (接口方法名)。

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

access_token: 商家授權(quán)后獲得的訪問令牌。

timestamp: 請求發(fā)起時的時間戳 (Unix 時間戳，精確到秒)。

data_type: 通常為 JSON。

version: API 版本號 (如 V1)。

sign: 對請求參數(shù)進(jìn)行簽名生成的字符串，用于驗證請求合法性。簽名算法通常是 MD5 或 HMAC-SHA256，具體算法和規(guī)則詳見官方文檔。簽名是安全調(diào)用的關(guān)鍵。

簽名生成示例 (偽代碼概念)： 簽名通常是將所有請求參數(shù)（除去 sign 本身）按特定規(guī)則（如字母順序）排序后拼接成一個字符串，然后加上 client_secret，再進(jìn)行哈希運(yùn)算（如 MD5）。公式可表示為： $$ text{sign} = text{hash}(text{param_key1=value1?m_key2=value2&...&client_secret=your_client_secret}) $$

2.3 處理響應(yīng)

接口成功調(diào)用后，會返回一個 JSON 格式的響應(yīng)。響應(yīng)結(jié)構(gòu)通常包含：

code: 狀態(tài)碼 (例如 0 表示成功)。

msg: 狀態(tài)信息。

data: 包含具體數(shù)據(jù)。對于店鋪列表接口，data 下通常會有一個數(shù)組（如 mall_list），數(shù)組中的每個元素代表一個店鋪對象，包含字段如：

mall_id: 店鋪唯一標(biāo)識。

mall_name: 店鋪名稱。

logo_url: 店鋪 Logo 圖片地址。

is_enable: 店鋪狀態(tài) (是否啟用) 等。

3. 代碼示例 (Python)

以下是一個使用 Python requests 庫調(diào)用接口的簡化示例。請務(wù)必替換 client_id, client_secret, access_token 為你自己的有效值，并根據(jù)官方文檔調(diào)整參數(shù)名、簽名算法和數(shù)據(jù)結(jié)構(gòu)。

import requests
import time
import hashlib
import urllib.parse

# 替換為你的實(shí)際信息
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
access_token = "YOUR_ACCESS_TOKEN"

# API 地址 (請確認(rèn))
api_url = "https://api.pinduoduo.com/router/router"

# 構(gòu)造基本參數(shù)
params = {
    "type": "pdd.mall.info.list.get",  # 假設(shè)的接口方法名，請核實(shí)
    "client_id": client_id,
    "access_token": access_token,
    "timestamp": str(int(time.time())),  # 當(dāng)前時間戳
    "data_type": "JSON",
    "version": "V1"  # 版本號
}

# 1. 生成簽名
# 步驟 a: 按鍵名排序 (官方文檔指定順序)
sorted_keys = sorted(params.keys())
# 步驟 b: 拼接鍵值對 (key=value)
param_str = "&".join([f"{key}={params[key]}" for key in sorted_keys])
# 步驟 c: 拼接 client_secret (示例用 MD5, 具體算法看文檔)
sign_str = param_str + client_secret
sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
# 步驟 d: 添加簽名到參數(shù)
params["sign"] = sign

# 2. 發(fā)送 POST 請求
response = requests.post(api_url, data=params)

# 3. 處理響應(yīng)
if response.status_code == 200:
    resp_json = response.json()
    # 檢查業(yè)務(wù)狀態(tài)碼
    if resp_json.get("code") == 0:  # 假設(shè)成功碼為0
        mall_list = resp_json["data"]["mall_list"]  # 假設(shè)的字段名
        for mall in mall_list:
            print(f"店鋪ID: {mall['mall_id']}, 店鋪名: {mall['mall_name']}")
    else:
        print(f"接口調(diào)用失敗! Code: {resp_json['code']}, Msg: {resp_json['msg']}")
else:
    print(f"HTTP 請求失敗! 狀態(tài)碼: {response.status_code}")

4. 注意事項

官方文檔為準(zhǔn)： 本文基于通用電商平臺 API 模式撰寫。拼多多開放平臺的具體接口名稱、參數(shù)、簽名算法、請求地址、返回字段結(jié)構(gòu) 必須嚴(yán)格以官方最新文檔為準(zhǔn)。開發(fā)者需經(jīng)常查閱 拼多多開放平臺文檔中心。

權(quán)限與授權(quán)： 確保你的應(yīng)用已經(jīng)申請了相應(yīng)的 API 權(quán)限（如“店鋪信息讀取”），并且商家已經(jīng)成功授權(quán)給你的應(yīng)用。

Access Token 有效期： access_token 通常有有效期（如 24 小時），過期后需使用 refresh_token 重新獲取。開發(fā)中需要處理 token 刷新邏輯。

簽名安全： 簽名算法是保障 API 調(diào)用安全的核心，務(wù)必按照官方文檔正確實(shí)現(xiàn)，避免泄露 client_secret。

調(diào)用頻率限制： 拼多多 API 對調(diào)用頻率有限制，超出限制會被限流或禁止訪問。開發(fā)時需注意控制調(diào)用頻率或處理限流異常。

錯誤處理： 代碼中需要完善處理各種可能的錯誤情況（網(wǎng)絡(luò)錯誤、API 返回錯誤、數(shù)據(jù)解析錯誤等）。

參數(shù)校驗： 請求參數(shù)需要符合接口要求，否則可能導(dǎo)致調(diào)用失敗。

5. 總結(jié)

通過拼多多開放平臺的 pdd.mall.info.list.get (或類似) 接口，開發(fā)者可以獲取授權(quán)賬號下的店鋪列表信息。關(guān)鍵在于正確理解和使用 OAuth2.0 授權(quán)流程、構(gòu)造符合要求的 HTTP 請求（特別是簽名）、以及解析處理返回的 JSON 數(shù)據(jù)。開發(fā)者應(yīng)始終以拼多多開放平臺的官方文檔為最高指導(dǎo)。

審核編輯 黃宇