2.2 接口調(diào)用

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

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

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

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

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

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

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

data_type: 通常為 JSON。

version: API 版本號(hào) (如 V1)。

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

簽名生成示例 (偽代碼概念)： 簽名通常是將所有請(qǐng)求參數(shù)（除去 sign 本身）按特定規(guī)則（如字母順序）排序后拼接成一個(gè)字符串，然后加上 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)用后，會(huì)返回一個(gè) JSON 格式的響應(yīng)。響應(yīng)結(jié)構(gòu)通常包含：

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

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

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

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

mall_name: 店鋪名稱(chēng)。

logo_url: 店鋪 Logo 圖片地址。

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

3. 代碼示例 (Python)

以下是一個(gè)使用 Python requests 庫(kù)調(diào)用接口的簡(jiǎn)化示例。請(qǐng)務(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 地址 (請(qǐng)確認(rèn))
api_url = "https://api.pinduoduo.com/router/router"

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

# 1. 生成簽名
# 步驟 a: 按鍵名排序 (官方文檔指定順序)
sorted_keys = sorted(params.keys())
# 步驟 b: 拼接鍵值對(duì) (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 請(qǐng)求
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 請(qǐng)求失敗! 狀態(tài)碼: {response.status_code}")

4. 注意事項(xiàng)

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

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

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

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

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

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

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

5. 總結(jié)

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

審核編輯 黃宇