?

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

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

1. 賬號資質(zhì)申請（雙平臺對比）

關(guān)鍵提示：

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

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

2. 核心憑證獲取（通用流程）

雙平臺均需獲取 3 類核心憑證，需在官方開放平臺完成，禁止非正規(guī)渠道獲取：

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

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

獲取憑證：審核通過后在 “應(yīng)用詳情” 頁獲取：

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

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

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

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

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

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

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

1.1 接口核心信息

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

請求方式：HTTPS GET；

核心參數(shù)：

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

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

python

運行

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

運行

def get_taobao_item_detail(num_iid):
    """淘寶商品詳情接口調(diào)用（企業(yè)賬號版）"""
    # 從環(huán)境變量獲取憑證（安全最佳實踐）
    app_key = os.getenv("TAOBAO_APP_KEY")
    app_secret = os.getenv("TAOBAO_APP_SECRET")
    access_token = os.getenv("TAOBAO_ACCESS_TOKEN")
    
    # 1. 構(gòu)造請求參數(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ā)送請求
    try:
        response = requests.get(
            url="https://eco.taobao.com/router/rest",
            params=params,
            timeout=10,
            verify=True  # 強制SSL驗證，保障安全
        )
        response.raise_for_status()  # 捕獲HTTP錯誤（如404、500）
        result = response.json()
    except requests.exceptions.RequestException as e:
        raise Exception(f"淘寶API請求失?。簕str(e)}")
    
    # 4. 處理錯誤響應(yīng)
    if "error_response" in result:
        error = result["error_response"]
        raise Exception(f"淘寶API錯誤[{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"],
        "售價": item_data["price"],
        "庫存": item_data["stock"],
        "AI標(biāo)簽": item_data.get("ai_tag", "無"),  # 處理字段可能不存在的情況
        "SKU數(shù)量": len(item_data.get("sku", []))
    }

# 調(diào)用示例
if __name__ == "__main__":
    try:
        taobao_item = get_taobao_item_detail(num_iid="123456789012")  # 替換為實際商品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ǔ)信息、價格、庫存等數(shù)據(jù)；

請求方式：HTTPS POST；

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

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

python

運行

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"格式（無需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

運行

def get_jd_item_detail(sku_id):
    """京東商品詳情接口調(diào)用（企業(yè)賬號版）"""
    # 從環(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)造請求參數(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ù)售鎖庫狀態(tài)字段
    }
    
    # 2. 生成簽名
    params["sign"] = generate_jd_sign(params, app_secret)
    
    # 3. 發(fā)送POST請求（京東部分接口要求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請求失敗：{str(e)}")
    
    # 4. 處理錯誤響應(yīng)
    if "error_response" in result:
        error = result["error_response"]
        raise Exception(f"京東API錯誤[{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"],
        "售價": item_data["price"],
        "可用庫存": 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")  # 替換為實際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)用高頻問題解決方案（雙平臺通用）

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

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

常見原因與解決方案：

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

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

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

python

運行

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)用時通過裝飾器限流
taobao_item = taobao_api_wrapper(get_taobao_item_detail, num_iid="123456789012")

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

問題表現(xiàn)：API 返回的庫存 / 價格與平臺頁面不一致；

解決方案：

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

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

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

四、雙平臺 API 合規(guī)使用要點（避免賬號風(fēng)險）

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

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

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

權(quán)限越界：

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

頻率突破：

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

隱私保護(hù)：

禁止存儲買家手機號、地址等敏感信息，若需使用需加密處理（如 AES-256）。

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

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

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

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

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

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

?
審核編輯 黃宇