?

在電商開發這條路上摸爬滾打了七八年，從創業公司的小項目到百萬級用戶的平臺開發，踩過的API坑能寫本血淚史。今天不聊虛的，就分享點實打實的實戰經驗和代碼，都是熬夜調試出來的“救命稻草”。

剛入行時做個簡單的商品比價功能，想著調用幾個平臺API拉數據就行。結果第一個坑就栽在京東API上——人家要求必須用HTTPS，而且簽名算藏在犄角旮旯的文檔里。當時對著文檔折騰了兩天，才把簽名邏輯啃明白，最后封裝出了這個工具函數：

import hashlib
import hmac
import time

def generate_signature(params, secret_key):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    query_string = "&".join([f"{k}={v}" for k, v in sorted_params])
    timestamp = str(int(time.time()))
    string_to_sign = f"{query_string}×tamp={timestamp}"
    signature = hmac.new(secret_key.encode('utf-8'), string_to_sign.encode('utf-8'), hashlib.sha256).hexdigest()
    return {**params, "timestamp": timestamp, "signature": signature}

# 使用示例
api_params = {
    "method": "jd.item.get",
    "app_key": "your_app_key",
    "item_id": "12345678"
}
signed_params = generate_signature(api_params, "your_secret_key")

解決了簽名問題，又碰上數據格式不兼容的大麻煩。淘寶、拼多多API接口返回的JSON結構完全不同，尤其是商品屬性字段命名五花八門。那段時間天天對著三個平臺的API文檔寫適配代碼，最后干脆抽象出一個通用解析函數：

def parse_product_data(raw_data, platform):
    if platform == "taobao":
        return {
            "title": raw_data.get("item_title", ""),
            "price": float(raw_data.get("item_price", 0)),
            "stock": int(raw_data.get("item_stock", 0)),
            "images": raw_data.get("item_images", [])
        }
    elif platform == "pdd":
        return {
            "title": raw_data.get("goods_name", ""),
            "price": float(raw_data.get("group_price", 0)),
            "stock": int(raw_data.get("goods_quantity", 0)),
            "images": raw_data.get("goods_image_urls", [])
        }
    return {}

更崩潰的是接口突然改版。有次半夜接到運營電話，說商品詳情頁數據全亂了。緊急排查發現平臺偷偷升級了API版本，老接口返回的數據格式完全變了。從那以后，每次調用API都會加數據校驗層：

def validate_product_data(data):
    required_fields = ["title", "price", "stock"]
    for field in required_fields:
        if field not in data:
            raise ValueError(f"Missing required field: {field}")
    return True

緩存這塊也踩過不少坑。最開始用簡單的內存緩存，結果服務器一重啟數據全丟。后來改用Redis，結合redis-py庫實現了帶過期時間的緩存策略：

import redis

redis_client = redis.Redis(host='localhost', port=6379, db=0)

def get_cached_data(key):
    data = redis_client.get(key)
    return data.decode('utf-8') if data else None

def set_cached_data(key, value, ex=300):
    redis_client.setex(key, ex, value)

# 使用示例
product_key = "product:12345"
cached_data = get_cached_data(product_key)
if cached_data:
    product_info = eval(cached_data)
else:
    product_info = fetch_product_from_api()
    set_cached_data(product_key, str(product_info))

現在接新項目，第一件事就是寫個測試腳手架。用pytest搭了個簡易測試框架，專門用來驗證API調用邏輯：

import pytest
import requests

@pytest.fixture
def api_url():
    return "https://api.example.com/product"

def test_api_call(api_url):
    response = requests.get(api_url, params={"product_id": "12345"})
    assert response.status_code == 200
    assert "title" in response.json()

這些代碼片段都是從真實項目里摳出來的，雖然不是完整工程，但每個功能都經過生產環境驗證。如果你在API開發中也遇到過奇葩問題，歡迎在評論區聊聊，說不定能一起碰撞出解決方案！

?審核編輯 黃宇