?

一、前置準(zhǔn)備：雙平臺(tái)資質(zhì)與核心憑證獲取

無(wú)論對(duì)接淘寶還是京東，合規(guī)資質(zhì)是 API 調(diào)用的前提，兩者流程相似但權(quán)限要求有差異，需針對(duì)性準(zhǔn)備。

1. 賬號(hào)資質(zhì)申請(qǐng)（雙平臺(tái)對(duì)比）

關(guān)鍵提示：

個(gè)人賬號(hào)僅適合學(xué)習(xí)或小體量需求，商業(yè)化場(chǎng)景（如 ERP 對(duì)接、批量選品）必須用企業(yè)賬號(hào)，否則核心字段（如淘寶 SKU 庫(kù)存、京東預(yù)售狀態(tài)）無(wú)法獲??；

申請(qǐng)權(quán)限時(shí)需明確 “業(yè)務(wù)場(chǎng)景”（如 “企業(yè)內(nèi)部商品數(shù)據(jù)同步”），材料真實(shí)完整可縮短審核周期（1-3 個(gè)工作日）。

2. 核心憑證獲?。ㄍㄓ昧鞒蹋?/p>

雙平臺(tái)均需獲取 3 類核心憑證，需在官方開放平臺(tái)完成，禁止非正規(guī)渠道獲?。?/p>

注冊(cè)開發(fā)者賬號(hào)：登錄對(duì)應(yīng)平臺(tái)開放平臺(tái)（淘寶開放平臺(tái)、京東開放平臺(tái)），完成基礎(chǔ)信息填寫；

創(chuàng)建應(yīng)用：選擇 “電商服務(wù)” 類目，應(yīng)用名稱需與實(shí)際用途一致（如 “XX 企業(yè)商品管理系統(tǒng)”）；

獲取憑證：審核通過(guò)后在 “應(yīng)用詳情” 頁(yè)獲?。?/p>

App Key：應(yīng)用唯一標(biāo)識(shí)（公開信息，用于接口身份識(shí)別）；

App Secret：接口密鑰（必須存儲(chǔ)在服務(wù)器端，禁止前端代碼、客戶端暴露）；

AccessToken：用戶 / 店鋪授權(quán)憑證（通過(guò) OAuth2.0 流程獲取，淘寶有效期 30 天，京東有效期 2 小時(shí)，需定時(shí)刷新）。

安全規(guī)范：App Secret建議通過(guò)服務(wù)器環(huán)境變量讀取（如 Python 用os.getenv("TAOBAO_APP_SECRET")），禁止硬編碼或提交至代碼倉(cāng)庫(kù)。

二、核心 API 調(diào)用實(shí)戰(zhàn)：雙平臺(tái)高頻接口落地

本節(jié)聚焦淘寶、京東最常用的商品詳情接口（淘寶item.get、京東item_detail），拆解從參數(shù)構(gòu)造到響應(yīng)解析的完整流程，代碼可直接復(fù)制復(fù)用。

1. 淘寶 API 調(diào)用：item.get（商品詳情）

1.1 接口核心信息

接口用途：獲取商品標(biāo)題、價(jià)格、庫(kù)存、SKU 等核心信息；

請(qǐng)求方式：HTTPS GET；

核心參數(shù)：

1.2 簽名生成（淘寶 MD5 算法）

淘寶 API 簽名需按 “參數(shù) ASCII 升序排序 + MD5 加密” 實(shí)現(xiàn)，是調(diào)用成功的關(guān)鍵：

python

運(yùn)行

import hashlib
import time
import os
import requests

def generate_taobao_sign(params, app_secret):
    """生成淘寶API簽名（MD5算法）"""
    # 1. 排除sign參數(shù)，按參數(shù)名ASCII升序排序
    sorted_params = sorted([(k, v) for k, v in params.items() if k != "sign"])
    # 2. 拼接為"key=value&key=value"格式
    sign_str = "&".join([f"{k}={v}" for k, v in sorted_params])
    # 3. 末尾拼接AppSecret，MD5加密后轉(zhuǎn)大寫
    sign_str += app_secret
    return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()

1.3 完整調(diào)用代碼

python

運(yùn)行

def get_taobao_item_detail(num_iid):
    """淘寶商品詳情接口調(diào)用（企業(yè)賬號(hào)版）"""
    # 從環(huán)境變量獲取憑證（安全最佳實(shí)踐）
    app_key = os.getenv("TAOBAO_APP_KEY")
    app_secret = os.getenv("TAOBAO_APP_SECRET")
    access_token = os.getenv("TAOBAO_ACCESS_TOKEN")
    
    # 1. 構(gòu)造請(qǐng)求參數(shù)
    params = {
        "method": "taobao.item.get",
        "app_key": app_key,
        "access_token": access_token,
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
        "format": "json",
        "v": "2.0",
        "num_iid": num_iid,
        "fields": "num_iid,title,price,stock,sku,ai_tag"  # 2024年新增AI標(biāo)簽字段
    }
    
    # 2. 生成簽名
    params["sign"] = generate_taobao_sign(params, app_secret)
    
    # 3. 發(fā)送請(qǐng)求
    try:
        response = requests.get(
            url="https://eco.taobao.com/router/rest",
            params=params,
            timeout=10,
            verify=True  # 強(qiáng)制SSL驗(yàn)證，保障安全
        )
        response.raise_for_status()  # 捕獲HTTP錯(cuò)誤（如404、500）
        result = response.json()
    except requests.exceptions.RequestException as e:
        raise Exception(f"淘寶API請(qǐng)求失?。簕str(e)}")
    
    # 4. 處理錯(cuò)誤響應(yīng)
    if "error_response" in result:
        error = result["error_response"]
        raise Exception(f"淘寶API錯(cuò)誤[{error['code']}]：{error['msg']}")
    
    # 5. 解析核心數(shù)據(jù)
    item_data = result["item_get_response"]["item"]
    return {
        "商品ID": item_data["num_iid"],
        "標(biāo)題": item_data["title"],
        "售價(jià)": item_data["price"],
        "庫(kù)存": item_data["stock"],
        "AI標(biāo)簽": item_data.get("ai_tag", "無(wú)"),  # 處理字段可能不存在的情況
        "SKU數(shù)量": len(item_data.get("sku", []))
    }

# 調(diào)用示例
if __name__ == "__main__":
    try:
        taobao_item = get_taobao_item_detail(num_iid="123456789012")  # 替換為實(shí)際商品ID
        print("淘寶商品詳情：")
        for k, v in taobao_item.items():
            print(f"{k}：{v}")
    except Exception as e:
        print(f"調(diào)用失敗：{str(e)}")

2. 京東 API 調(diào)用：item_detail（商品詳情）

2.1 接口核心信息

接口用途：獲取京東商品基礎(chǔ)信息、價(jià)格、庫(kù)存等數(shù)據(jù)；

請(qǐng)求方式：HTTPS POST；

核心差異：京東簽名算法為HMAC-SHA256（區(qū)別于淘寶 MD5），需特別注意。

2.2 簽名生成（京東 HMAC-SHA256 算法）

python

運(yùn)行

import hmac
import hashlib

def generate_jd_sign(params, app_secret):
    """生成京東API簽名（HMAC-SHA256算法）"""
    # 1. 按參數(shù)名ASCII升序排序
    sorted_params = sorted([(k, v) for k, v in params.items() if k != "sign"])
    # 2. 拼接為"key=value&key=value"格式（無(wú)需URL編碼）
    sign_str = "&".join([f"{k}={v}" for k, v in sorted_params])
    # 3. 用AppSecret作為密鑰，HMAC-SHA256加密后轉(zhuǎn)大寫
    sign = hmac.new(
        app_secret.encode("utf-8"),
        sign_str.encode("utf-8"),
        hashlib.sha256
    ).hexdigest().upper()
    return sign

2.3 完整調(diào)用代碼

python

運(yùn)行

def get_jd_item_detail(sku_id):
    """京東商品詳情接口調(diào)用（企業(yè)賬號(hào)版）"""
    # 從環(huán)境變量獲取憑證
    app_key = os.getenv("JD_APP_KEY")
    app_secret = os.getenv("JD_APP_SECRET")
    access_token = os.getenv("JD_ACCESS_TOKEN")
    
    # 1. 構(gòu)造請(qǐng)求參數(shù)
    params = {
        "method": "item_detail",
        "app_key": app_key,
        "access_token": access_token,
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
        "format": "json",
        "v": "2.0",
        "skuId": sku_id,  # 京東商品用SKU ID，區(qū)別于淘寶num_iid
        "fields": "skuId,title,price,stockNum,preSaleLock"  # 含預(yù)售鎖庫(kù)狀態(tài)字段
    }
    
    # 2. 生成簽名
    params["sign"] = generate_jd_sign(params, app_secret)
    
    # 3. 發(fā)送POST請(qǐng)求（京東部分接口要求POST）
    try:
        response = requests.post(
            url="https://api.jd.com/routerjson",
            data=params,
            timeout=10,
            verify=True
        )
        response.raise_for_status()
        result = response.json()
    except requests.exceptions.RequestException as e:
        raise Exception(f"京東API請(qǐng)求失敗：{str(e)}")
    
    # 4. 處理錯(cuò)誤響應(yīng)
    if "error_response" in result:
        error = result["error_response"]
        raise Exception(f"京東API錯(cuò)誤[{error['code']}]：{error['msg']}")
    
    # 5. 解析核心數(shù)據(jù)
    item_data = result["item_detail_response"]["result"]
    return {
        "SKU ID": item_data["skuId"],
        "標(biāo)題": item_data["title"],
        "售價(jià)": item_data["price"],
        "可用庫(kù)存": item_data["stockNum"],
        "是否預(yù)售": "是" if item_data.get("preSaleLock", 0) > 0 else "否"
    }

# 調(diào)用示例
if __name__ == "__main__":
    try:
        jd_item = get_jd_item_detail(sku_id="100012345678")  # 替換為實(shí)際SKU ID
        print("n京東商品詳情：")
        for k, v in jd_item.items():
            print(f"{k}：{v}")
    except Exception as e:
        print(f"調(diào)用失?。簕str(e)}")

三、API 調(diào)用高頻問(wèn)題解決方案（雙平臺(tái)通用）

在實(shí)際調(diào)用中，簽名失敗、頻率超限、數(shù)據(jù)不一致是最常見的問(wèn)題，以下提供可落地的解決策略。

1. 簽名失?。ㄕ急?60% 的入門坑）

常見原因與解決方案：

2. 調(diào)用頻率超限（429 錯(cuò)誤）

淘寶企業(yè)賬號(hào)：≤100 次 / 分鐘，京東企業(yè)賬號(hào)≤80 次 / 分鐘，建議按80% 配額設(shè)置限流（如淘寶設(shè) 80 次 / 分鐘）；

解決方案：用令牌桶算法實(shí)現(xiàn)動(dòng)態(tài)限流，示例代碼：

python

運(yùn)行

from ratelimit import limits, sleep_and_retry

# 淘寶API限流：80次/分鐘
@sleep_and_retry
@limits(calls=80, period=60)
def taobao_api_wrapper(func, *args, **kwargs):
    return func(*args, **kwargs)

# 調(diào)用時(shí)通過(guò)裝飾器限流
taobao_item = taobao_api_wrapper(get_taobao_item_detail, num_iid="123456789012")

3. 數(shù)據(jù)不一致（業(yè)務(wù)核心坑）

問(wèn)題表現(xiàn)：API 返回的庫(kù)存 / 價(jià)格與平臺(tái)頁(yè)面不一致；

解決方案：

緩存策略：熱門商品用 Redis 緩存（有效期 5-10 分鐘），庫(kù)存數(shù)據(jù)縮短至 1 分鐘；

增量同步：記錄商品上次更新時(shí)間，僅同步modified_time晚于該時(shí)間的數(shù)據(jù)；

回調(diào)補(bǔ)漏：開通平臺(tái) “商品變更回調(diào)”（如淘寶item_updated），實(shí)時(shí)接收數(shù)據(jù)更新通知。

四、雙平臺(tái) API 合規(guī)使用要點(diǎn)（避免賬號(hào)風(fēng)險(xiǎn)）

平臺(tái)對(duì) API 合規(guī)要求嚴(yán)格，以下行為將導(dǎo)致權(quán)限回收或賬號(hào)封禁，需嚴(yán)格規(guī)避：

數(shù)據(jù)濫用：

淘寶：禁止將商品數(shù)據(jù)用于 “惡意比價(jià)”“競(jìng)價(jià)排名”；京東：禁止將庫(kù)存數(shù)據(jù)用于第三方商業(yè)推廣；

權(quán)限越界：

個(gè)人賬號(hào)不得嘗試調(diào)用企業(yè)級(jí)接口（如淘寶trade.fullinfo.get訂單接口）；

頻率突破：

禁止用 “多賬號(hào)輪調(diào)”“代理 IP 切換” 繞過(guò)調(diào)用頻率限制；

隱私保護(hù)：

禁止存儲(chǔ)買家手機(jī)號(hào)、地址等敏感信息，若需使用需加密處理（如 AES-256）。

五、總結(jié)與工具推薦

本文覆蓋淘寶、京東雙平臺(tái) API 調(diào)用的核心流程，重點(diǎn)解決 “簽名生成”“問(wèn)題排查”“合規(guī)使用” 三大核心需求。推薦以下工具提升開發(fā)效率：

調(diào)試工具：Postman（預(yù)設(shè)雙平臺(tái) API 模板，支持簽名自動(dòng)生成）、ApiFox（多環(huán)境切換，適合團(tuán)隊(duì)協(xié)作）；

監(jiān)控工具：Prometheus+Grafana（可視化調(diào)用成功率、響應(yīng)時(shí)間）、Sentry（捕獲 API 錯(cuò)誤日志）；

文檔工具：Swagger（生成 API 接口文檔）、語(yǔ)雀（沉淀對(duì)接經(jīng)驗(yàn)）。

有任何 API 調(diào)用需求或問(wèn)題，歡迎評(píng)論區(qū)留言或私信交流，助力高效落地電商數(shù)據(jù)對(duì)接場(chǎng)景！

?
審核編輯 黃宇