零基础 3 天搞定京东 / 淘宝 API 开发，从注册到调通接口全流程拆解

引言
在当今数字化时代，电商 API 开发已成为众多开发者和创业者关注的热点。通过调用京东、淘宝等电商平台的 API，我们可以获取商品信息、订单数据、用户信息等，从而开发出各种各样的电商应用和服务。然而，对于零基础的开发者来说，电商 API 开发可能会显得有些困难。本文将带领大家从零基础开始，一步步学习京东 / 淘宝 API 开发，在 3 天内完成从注册到调通接口的全流程。
第一天：注册与环境准备
1.1 注册开发者账号
首先，我们需要在京东和淘宝的开放平台上注册开发者账号。
京东开放平台注册步骤：
访问京东开放平台
点击 "立即入驻"，填写企业或个人信息
完成实名认证和资质审核（通常需要 3-5 个工作日）
淘宝开放平台注册步骤：
访问淘宝开放平台
使用淘宝 / 支付宝账号登录
完成开发者实名认证
1.2 创建应用
注册成功后，我们需要在平台上创建应用，以获取 API 调用所需的凭证。
京东开放平台创建应用：
登录开放平台控制台
进入 "应用管理" 页面，点击 "创建应用"
选择应用类型（如 "Web 应用" 或 "移动应用"）
填写应用基本信息（名称、描述、回调 URL 等）
提交审核（通常需要 1-2 个工作日）
淘宝开放平台创建应用：
进入应用管理页面
点击 "创建应用" 按钮
选择应用类型（如 "网页应用" 或 "移动应用"）
填写应用基本信息（名称、描述等）
提交审核（通常需要 1-3 个工作日）
1.3 获取应用凭证
应用审核通过后，我们可以获取以下重要凭证：
AppKey：应用的唯一标识
AppSecret：用于生成签名的密钥
AccessToken：访问令牌（部分 API 需要）
1.4 开发环境准备
为了进行 API 开发，我们需要准备以下开发环境：
Python 环境（推荐 Python 3.7 及以上版本）
开发工具（如 PyCharm、VS Code 等）
HTTP 客户端工具（如 Postman，用于测试 API）
安装 Python 和配置开发环境的详细步骤可以参考官方文档或其他相关教程。
第二天：API 认证与基础调用
2.1 API 认证机制
京东和淘宝的 API 都采用了签名机制来确保请求的安全性。下面我们分别介绍这两个平台的签名生成方法。
京东 API 签名生成步骤：
将所有请求参数（包括公共参数和业务参数）按参数名 ASCII 码从小到大排序
将排序后的参数名和参数值连接成一个字符串
在字符串首尾加上 AppSecret
使用 MD5 算法对字符串进行加密，转换为大写
淘宝 API 签名生成步骤：
淘宝的签名生成方法与京东类似，但有一些细微差别：
将所有请求参数（包括公共参数和业务参数）按参数名 ASCII 码从小到大排序
将排序后的参数名和参数值连接成一个字符串
在字符串首尾加上 AppSecret
使用 MD5 算法对字符串进行加密，转换为大写
下面是 Python 实现的签名生成函数：
python
运行
import hashlib
import time

def generate_sign(params, app_secret):
"""生成API签名"""

# 排序参数
sorted_params = sorted(params.items(), key=lambda x: x[0])

# 拼接参数字符串
sign_str = app_secret
for k, v in sorted_params:
    sign_str += f"{k}{v}"
sign_str += app_secret

# 计算MD5
sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
return sign

def get_common_params(app_key, method):
"""获取公共请求参数"""
return {
"app_key": app_key,
"method": method,
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
"format": "json",
"v": "2.0",
"sign_method": "md5"
}
2.2 API 基础调用
有了签名生成函数，我们就可以开始调用 API 了。下面是一个简单的 Python 类，用于调用京东和淘宝的 API：
python
运行
import requests

class EcommerceAPI:
def init(self, app_key, app_secret, api_type='jd'):
"""初始化电商API客户端"""
self.app_key = app_key
self.app_secret = app_secret
self.api_type = api_type

    # 根据API类型设置不同的基础URL
    if api_type == 'jd':
        self.base_url = "https://api.jd.com/routerjson"
    elif api_type == 'taobao':
        self.base_url = "https://eco.taobao.com/router/rest"
    else:
        raise ValueError("不支持的API类型")

def call(self, method, params=None):
    """调用API接口"""
    if params is None:
        params = {}

    # 添加公共参数
    common_params = get_common_params(self.app_key, method)
    all_params = {**common_params, **params}

    # 生成签名
    sign = generate_sign(all_params, self.app_secret)
    all_params["sign"] = sign

    # 发送请求
    try:
        response = requests.post(self.base_url, data=all_params, timeout=30)
        response.raise_for_status()
        return response.json()
    except Exception as e:
        print(f"API请求失败: {e}")
        return None

2.3 调用示例
下面是一个调用京东商品搜索 API 的示例：
python
运行
初始化API客户端
api = EcommerceAPI(
app_key="你的AppKey",
app_secret="你的AppSecret",
api_type='jd'
)

调用商品搜索API
method = "jingdong.search.v3.product.search"
params = {
"keyword": "手机",
"page": 1,
"pageSize": 10
}

result = api.call(method, params)
print(json.dumps(result, indent=2, ensure_ascii=False))
第三天：高级应用与实战项目
3.1 数据解析与存储
API 返回的数据通常是 JSON 格式的，我们需要对其进行解析并存储到数据库中。下面是一个简单的数据解析和存储示例：
python
运行
import pymongo
from datetime import datetime

class DataProcessor:
def init(self, db_host='localhost', db_port=27017, db_name='ecommerce_data'):
"""初始化数据处理器"""
self.client = pymongo.MongoClient(db_host, db_port)
self.db = self.client[db_name]

def process_product_data(self, api_result, api_type):
    """处理商品数据"""
    if not api_result:
        return

    collection_name = f"{api_type}_products"
    collection = self.db[collection_name]

    # 根据不同API类型解析数据
    if api_type == 'jd':
        products = api_result.get('jingdong_search_v3_product_search_response', {}).get('result', {}).get('productInfoList', [])
    elif api_type == 'taobao':
        products = api_result.get('tbk_item_get_response', {}).get('results', {}).get('n_tbk_item', [])
    else:
        products = []

    for product in products:
        # 添加更新时间
        product["update_time"] = datetime.now()

        # 存储到数据库
        if api_type == 'jd' and 'skuId' in product:
            collection.update_one({"skuId": product["skuId"]}, {"$set": product}, upsert=True)
        elif api_type == 'taobao' and 'num_iid' in product:
            collection.update_one({"num_iid": product["num_iid"]}, {"$set": product}, upsert=True)

def close(self):
    """关闭数据库连接"""
    self.client.close()

3.2 实战项目：商品价格监控系统
作为一个实战项目，我们可以开发一个简单的商品价格监控系统。这个系统可以定期获取商品价格信息，并在价格变化时发送通知。
下面是一个基本的商品价格监控系统实现：
python
运行
import time
import schedule
from datetime import datetime

class PriceMonitor:
def init(self, api_client, data_processor, sku_list):
"""初始化价格监控系统"""
self.api_client = api_client
self.data_processor = data_processor
self.sku_list = sku_list
self.price_history = {}

def get_price(self, sku_id):
    """获取单个商品价格"""
    method = "jingdong.ware.productinfo.get"  # 京东商品信息API
    params = {
        "skuIds": sku_id,
        "field": "skuId,price"
    }

    result = self.api_client.call(method, params)
    if result:
        product_info = result.get('jingdong_ware_productinfo_get_response', {}).get('queryProductInfoResult', {}).get('productInfoList', [])
        if product_info:
            return product_info[0].get('price')
    return None

def check_price_changes(self):
    """检查价格变化"""
    print(f"开始检查价格: {datetime.now()}")

    for sku_id in self.sku_list:
        current_price = self.get_price(sku_id)
        if current_price is None:
            print(f"获取商品 {sku_id} 价格失败")
            continue

        # 检查价格历史
        if sku_id in self.price_history:
            old_price = self.price_history[sku_id]
            if current_price != old_price:
                print(f"商品 {sku_id} 价格变化: {old_price} -> {current_price}")
                # 这里可以添加发送通知的逻辑
        else:
            print(f"记录商品 {sku_id} 初始价格: {current_price}")

        # 更新价格历史
        self.price_history[sku_id] = current_price

    print(f"价格检查完成: {datetime.now()}")

def start_monitoring(self, interval=60):
    """开始监控"""
    print(f"启动价格监控系统，监控间隔: {interval}分钟")
    self.check_price_changes()  # 立即检查一次

    # 设置定时任务
    schedule.every(interval).minutes.do(self.check_price_changes)

    # 运行定时任务
    while True:
        schedule.run_pending()
        time.sleep(1)

3.3 运行监控系统
使用上面实现的类，我们可以轻松地启动一个商品价格监控系统：
python
运行
初始化API客户端
api_client = EcommerceAPI(
app_key="你的AppKey",
app_secret="你的AppSecret",
api_type='jd'
)

初始化数据处理器
data_processor = DataProcessor()

监控的商品SKU列表
sku_list = ["100012345678", "100012345679", "100012345680"] # 示例SKU

初始化价格监控系统
monitor = PriceMonitor(api_client, data_processor, sku_list)

开始监控（每小时检查一次价格）
monitor.start_monitoring(interval=60)
总结与展望
通过这三天的学习，我们已经完成了从注册开发者账号到实现一个简单的商品价格监控系统的全过程。当然，电商 API 开发还有很多更深入的内容值得学习，例如：
更多 API 接口的使用（如订单管理、物流查询等）
API 调用的性能优化
数据的深度分析与应用
与其他系统的集成
希望这篇教程能够帮助你快速入门电商 API 开发，在这个领域取得成功！