跨境电商最核心、最常用的接口集中在 商品、订单、库存、物流、支付、店铺 / 授权 六大类。下面按 全球主流平台（亚马逊、Shopify、速卖通、Shopee、eBay） 给出 常用接口清单 + 标准接入流程 + 关键技术点。

---

一、跨境电商最常用接口分类（通用）

1. 商品类（必用）

• 商品列表 / 搜索：获取平台商品、类目、筛选条件
• 商品详情：标题、SKU、价格、图片、描述、属性、类目
• 商品上下架 / 更新：发布、编辑、库存 / 价格批量同步
• 商品类目 / 属性：获取平台类目树、必填属性

2. 订单类（必用）

• 订单列表 / 查询：拉取待发货 / 已完成 / 取消订单
• 订单详情：买家信息、商品明细、金额、地址、状态
• 订单发货 / 标记：上传物流单号、标记发货
• 订单取消 / 退款：取消订单、发起退款、查询退款

3. 库存与价格

• 库存查询 / 更新：实时库存、多仓库存、预留库存
• 价格查询 / 更新：原价、促销价、会员价批量修改

4. 物流与追踪

• 物流渠道 / 运费：获取支持物流、计算运费
• 物流单号创建 / 打印：面单、追踪号生成
• 物流轨迹查询：实时物流状态

5. 支付与财务

• 支付状态查询：订单是否已支付
• 结算 / 账单查询：平台结算单、佣金、费用明细

6. 店铺与授权

• 店铺信息：店铺名、状态、评分
• 授权 / Token 管理：获取 / 刷新 AccessToken
• 消息 / 通知：订单、商品、系统消息 Webhook

---

二、五大平台常用接口清单（2026 最新）

1. 亚马逊（Amazon SP-API）

文档：

最常用接口

• 商品
  • Products API：商品详情、价格、ASIN 匹配
  • Catalog Items API：类目、商品属性
• 订单
  • Orders API：订单列表 / 详情
  • Order Items API：订单商品明细
  • Shipments API：发货、FBA 物流
• 库存
  • Inventory API：FBA / 自发货库存
• 报告
  • Reports API：下载订单 / 库存 / 销售报告（必用）
• 授权
  • OAuth2.0 + AWS SigV4 签名

2. Shopify（独立站首选）

文档：

最常用接口（REST/GraphQL）

• 商品
  • GET /admin/api/2024-01/products.json：商品列表
  • GET /admin/api/2024-01/products/{id}.json：商品详情
• 订单
  • GET /admin/api/2024-01/orders.json：订单列表
  • POST /admin/api/2024-01/orders/{id}/fulfillments.json：发货
• 客户
  • GET /admin/api/2024-01/customers.json
• Webhook：订单创建 / 支付 / 发货自动通知

3. 速卖通（AliExpress）

文档：

最常用接口

• 商品
  • aliexpress.solution.product.list.query：商品列表
  • aliexpress.item.get：商品详情
• 订单
  • aliexpress.trade.order.get：订单详情
  • aliexpress.trade.order.ship：订单发货
• 物流
  • aliexpress.logistics.trace.query：物流追踪

4. Shopee（虾皮，东南亚）

文档：

最常用接口（v2 版本）

• 商品
  • /api/v2/product/get_items：商品列表
  • /api/v2/product/get_item_base_info：商品基础信息
• 订单
  • /api/v2/order/get_orders：订单列表
  • /api/v2/order/get_order_detail：订单详情
  • /api/v2/logistics/tracking：物流轨迹
• 授权：多站点（SG/MY/ID/TH/PH/BR 等）单独 shop_id + access_token

5. eBay

文档：

最常用接口

• 商品
  • buy/browse/v1/item_summary/search：商品搜索
  • buy/browse/v1/item/{item_id}：商品详情
• 订单
  • sell/fulfillment/v1/order：订单管理
• 库存
  • sell/inventory/v1/inventory_item

---

三、标准接入流程（通用五步）

1. 注册开发者账号 + 认证

• 亚马逊：AWS 开发者 + 卖家店铺关联
• Shopify：Shopify 账户 → 开发应用
• 速卖通 / Shopee：企业认证优先

2. 创建应用 & 获取密钥

• 获得：App Key / Client ID、App Secret / Client Secret
• 填写：回调 URL（OAuth 用）、权限范围

3. 申请接口权限

• 商品、订单、库存、物流等按业务勾选
• 部分平台需审核用途（亚马逊 / Shopee 较严）

4. 授权（OAuth2.0 主流）

1. 跳转平台授权页 → 用户授权
2. 回调拿到 code → 换取 access_token（有效期）
3. 用 refresh_token 续期

5. 签名与调用（核心）

• 通用规则
  • 协议：HTTPS
  • 格式：JSON
  • 签名：HMAC-SHA256 / MD5 / AWS SigV4（亚马逊）
  • 频率限制：严格限流（Shopify 约 40 次 / 分）

---

四、接入代码示例（Python 伪代码）

1. 通用请求模板

python

运行

import requests
import hashlib
import hmac
from datetime import datetime

def sign(params, app_secret):
    # 1. 参数按 key 排序
    sorted_params = sorted(params.items())
    # 2. 拼接字符串
    query_str = ''.join(f"{k}{v}" for k, v in sorted_params)
    # 3. HMAC-SHA256 加密
    sign = hmac.new(
        app_secret.encode(),
        query_str.encode(),
        hashlib.sha256
    ).hexdigest().upper()
    return sign

# 公共参数
params = {
    "app_key": "YOUR_APP_KEY",
    "method": "aliexpress.item.get",
    "timestamp": datetime.utcnow().strftime("%Y-%m-%d %H:%M:%S"),
    "format": "json",
    "item_id": "123456"
}
# 签名
params["sign"] = sign(params, "YOUR_APP_SECRET")
# 请求
resp = requests.post("https://api.xxxx.com/router", data=params)
print(resp.json())

2. Shopify 示例

python

运行

# 商品列表
headers = {
    "X-Shopify-Access-Token": "YOUR_TOKEN"
}
resp = requests.get(
    "https://your-shop.myshopify.com/admin/api/2024-01/products.json",
    headers=headers
)
print(resp.json())

---

五、接入常见坑与建议

1. 多站点处理

   • 亚马逊：MarketplaceId（US/CA/UK/DE 等）
   • Shopee：每个国家独立 shop_id、域名、Token
   • 速卖通：site=global/ru/es

2. 限流与重试

   • 必须做：限流、重试、队列、缓存
   • 高并发用：异步 + 消息队列（Kafka/RocketMQ）

3. 状态机统一

   • 各平台订单 / 物流状态不同 → 做内部状态映射

4. Webhook 优先

   • 订单 / 支付 / 发货用 Webhook 比轮询更高效

---

六、快速选型建议

• 北美 / 全球：亚马逊 SP-API（复杂但权威）
• 独立站：Shopify（文档友好、生态强）
• 东南亚：Shopee（多站点、文档清晰）
• B2C 全球：速卖通（阿里体系、易接入）
• 拍卖 / 二手：eBay