跨境电商最最常用的接口列表与接入

跨境电商最核心、最常用的接口集中在商品、订单、库存、物流、支付、店铺 / 授权六大类。下面按全球主流平台亚马逊、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 APIFBA / 自发货库存报告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.jsonWebhook订单创建 / 支付 / 发货自动通知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_idaccess_token5. eBay文档最常用接口商品buy/browse/v1/item_summary/search商品搜索buy/browse/v1/item/{item_id}商品详情订单sell/fulfillment/v1/order订单管理库存sell/inventory/v1/inventory_item三、标准接入流程通用五步1. 注册开发者账号 认证亚马逊AWS 开发者 卖家店铺关联ShopifyShopify 账户 → 开发应用速卖通 / Shopee企业认证优先2. 创建应用 获取密钥获得App Key / Client ID、App Secret / Client Secret填写回调 URLOAuth 用、权限范围3. 申请接口权限商品、订单、库存、物流等按业务勾选部分平台需审核用途亚马逊 / Shopee 较严4. 授权OAuth2.0 主流跳转平台授权页 → 用户授权回调拿到code→ 换取access_token有效期用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, dataparams) 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, headersheaders ) print(resp.json())五、接入常见坑与建议多站点处理亚马逊MarketplaceIdUS/CA/UK/DE 等Shopee每个国家独立shop_id、域名、Token速卖通siteglobal/ru/es限流与重试必须做限流、重试、队列、缓存高并发用异步 消息队列Kafka/RocketMQ状态机统一各平台订单 / 物流状态不同 → 做内部状态映射Webhook 优先订单 / 支付 / 发货用 Webhook 比轮询更高效六、快速选型建议北美 / 全球亚马逊 SP-API复杂但权威独立站Shopify文档友好、生态强东南亚Shopee多站点、文档清晰B2C 全球速卖通阿里体系、易接入拍卖 / 二手eBay