一、主流电商平台 API 概览（2026）

1. 平台与开放入口

表格

平台	开放平台入口	认证方式	费用模式	核心接口类型
淘宝 / 天猫		OAuth 2.0	按调用量计费	商品、订单、物流、店铺
京东（JOS）		AppKey + 签名 + Token	免费 + 增值	商品、订单、库存、联盟
拼多多		OAuth 2.0	按调用量计费	商品、订单、营销、物流
抖音电商		OAuth 2.0	按调用量计费	商品、订单、视频、直播
1688		AppKey + 签名	按调用量计费	商品、批发、供应链

2. 核心接口分类（按场景）

（1）商品数据类（比价 / 选品 / 监控）

• 淘宝：taobao.item.get（详情）、taobao.item.search（搜索）、taobao.item.sku.get（SKU）
• 京东：jd.item.get（详情）、jd.item.search（搜索）、jd.union.open.goods.promotiongoodsinfo.query（促销）
• 拼多多：pdd.ddk.goods.detail.get（商品详情）、pdd.ddk.goods.search（商品搜索）
• 抖音：douyin.item.detail.get（商品详情）、douyin.item.search（商品搜索）
• 1688：alibaba.item.get（商品详情）、alibaba.item.search（商品搜索）

（2）订单交易类（ERP / 订单同步）

• 淘宝：taobao.trade.fullinfo.get（订单详情）、taobao.trades.sold.get（已卖出订单）
• 京东：jd.order.detail.get（订单详情）、jd.order.search（订单查询）
• 拼多多：pdd.order.list.get（订单列表）、pdd.order.detail.get（订单详情）
• 抖音：douyin.trade.order.get（订单详情）、douyin.trade.order.list（订单列表）

（3）库存物流类（供应链 / 履约）

• 淘宝：taobao.inventory.get（库存）、taobao.logistics.trace.search（物流轨迹）
• 京东：jd.stock.get（库存）、jd.logistics.track.get（物流轨迹）
• 拼多多：pdd.stock.warehouse.query（库存）、pdd.logistics.trace.get（物流）
• 1688：alibaba.inventory.get（库存）、alibaba.logistics.trace.get（物流）

（4）店铺数据类（运营 / 报表）

• 淘宝：taobao.shop.get（店铺信息）、taobao.data.seller.get（店铺数据）
• 京东：jd.shop.get（店铺信息）、jd.data.sales.get（销售数据）

---

二、电商 API 通用接入指南（全平台适用）

1. 接入准备（必做）

1. 注册开发者账号
   • 用平台主账号（淘宝 / 京东 / 拼多多等）登录开放平台
   • 完成实名认证：个人 / 企业（企业账号权限更高、调用量更大）
2. 创建应用
   • 进入控制台 → 应用管理 → 创建应用
   • 选择类型：自用型 / 工具型 / 服务商型
   • 填写名称、用途、回调地址（OAuth 场景）
   • 提交审核（1–3 个工作日，企业更快）
3. 获取核心凭证
   • App Key：应用唯一标识（公开）
   • App Secret：签名密钥（严禁泄露，仅存服务器）
   • Access Token：用户 / 店铺授权（OAuth 2.0 获取，有效期短）
4. 申请接口权限
   • 按业务场景申请对应接口（如商品、订单）
   • 填写用途说明（如 “比价系统商品数据获取”）
   • 等待权限审核通过

2. 调用流程（通用）

1. 参数准备
   • 公共参数：app_key、method（接口名）、timestamp、format（json）、sign
   • 业务参数：如num_iid（淘宝商品 ID）、skuId（京东商品 ID）
2. 签名生成（核心）
   • 按参数名 ASCII 升序拼接：key1value1key2value2...
   • 首尾拼接App Secret
   • 用MD5/HMAC-SHA256加密，转大写得到sign
3. 发送请求
   • 方式：POST（推荐）/GET
   • 地址：平台网关域名（如https://eco.taobao.com/router/rest）
   • 携带所有参数 + 签名
4. 解析响应
   • 处理 JSON/XML 返回
   • 校验code：0 = 成功，非 0 = 错误（如限流、权限不足）
5. 异常处理
   • 限流（429）：降级、重试、缓存
   • 签名错误：核对参数排序、加密方式
   • 权限不足：检查权限申请与 Token 有效性

3. 接入实战（Python 示例：淘宝商品详情）

python

运行

import requests
import hashlib
import hmac
import time
from dotenv import load_dotenv
import os

load_dotenv()  # 从.env加载配置

# 配置
APP_KEY = os.getenv("TAOBAO_APP_KEY")
APP_SECRET = os.getenv("TAOBAO_APP_SECRET")
METHOD = "taobao.item.get"
NUM_IID = "1234567890"  # 商品ID
FORMAT = "json"
TIMESTAMP = str(int(time.time() * 1000))

# 1. 组装参数（按ASCII排序）
params = {
    "app_key": APP_KEY,
    "method": METHOD,
    "timestamp": TIMESTAMP,
    "format": FORMAT,
    "num_iid": NUM_IID,
    "fields": "num_iid,title,price,pic_url"
}

# 2. 生成签名
sorted_params = sorted(params.items())
sign_str = APP_SECRET + "".join(f"{k}{v}" for k, v in sorted_params) + APP_SECRET
sign = hmac.new(APP_SECRET.encode(), sign_str.encode(), hashlib.md5).hexdigest().upper()
params["sign"] = sign

# 3. 发送请求
url = "https://eco.taobao.com/router/rest"
response = requests.post(url, data=params)
result = response.json()

# 4. 处理结果
if "error_response" in result:
    print("调用失败：", result["error_response"])
else:
    print("商品信息：", result["item_get_response"]["item"])

---

三、各平台接入差异与要点

1. 淘宝 / 天猫（TOP）

• 认证：OAuth 2.0，access_token有效期 30 天，需刷新
• 签名：HMAC-SHA256/MD5，参数排序严格
• 调用量：个人≤10 次 / 分钟；企业≤100 次 / 分钟；服务商更高
• 限制：个人账号无法调用订单类接口（需企业认证）

2. 京东（JOS）

• 认证：AppKey + 签名 +access_token（有效期 2 小时）
• 签名：MD5，参数排序 + 拼接App Secret
• 调用量：企业≤80–100 次 / 分钟，可申请提升
• 优势：商品数据稳定，联盟接口完善，适合比价 / 导购

3. 拼多多

• 认证：OAuth 2.0，access_token短期有效
• 签名：MD5，参数排序 +client_secret
• 特点：接口字段简洁，适合快速接入，但权限审核较严

4. 抖音电商

• 认证：OAuth 2.0，需店铺授权
• 场景：侧重短视频 / 直播商品，适合内容电商数据获取

5. 1688

• 认证：AppKey + 签名，无 OAuth（B2B 场景）
• 特点：批发价、起订量、供应商信息丰富，适合供应链系统

---

四、接入常见问题与避坑

1. 调用限流（429）
   • 控制频率，不超平台配额
   • 批量任务用定时 + 分批
   • 热门接口加缓存（Redis）
2. 签名错误
   • 严格按ASCII 升序排序
   • 检查timestamp格式（毫秒 / 秒）
   • 核对App Secret是否正确
3. 权限不足
   • 确认接口权限已审核通过
   • 检查access_token是否过期 / 有效
   • 企业账号才能申请订单 / 库存等高权限接口
4. 数据延迟 / 缺失
   • 优先用官方最新接口
   • 大促期间适当提高调用频率（合规范围内）
   • 对缺失字段做兼容处理
5. 安全风险
   • App Secret绝不暴露在前端 / 配置文件
   • 接口请求走HTTPS
   • 定期轮换密钥，监控异常调用

---

五、选型建议

• 比价 / 选品：优先京东（jd.item.get）+ 淘宝（taobao.item.get），数据全、稳定
• 订单 / ERP：企业账号 + 淘宝 / 京东 / 拼多多订单接口，支持多平台同步
• B2B 供应链：1688 接口，批发数据完善
• 内容电商：抖音电商接口，适配短视频 / 直播场景