速卖通API老接口（AliExpress Open API v1/v2）下架时间公告与迁移指南

阿里速卖通已于2024年6月30日零时（UTC+8）正式终止对旧版开放平台API（v1/v2）的服务支持，所有调用将返回HTTP 404错误。此举系速卖通全球技术架构升级的关键节点，旨在统一接入标准、提升系统稳定性与数据安全性。

背景与政策依据

根据速卖通官方《Open Platform Migration Notice V3.0》（发布于2023年12月15日，文档编号AE-OP-20231215-01），平台明确要求：自2024年1月1日起停止新应用注册使用v1/v2接口；2024年4月1日起关闭v1/v2接口沙箱环境；2024年6月30日00:00起全面下线生产环境调用能力。该时间节点已通过卖家后台站内信、API控制台弹窗及速卖通开发者官网（developers.aliexpress.com）三次公告确认，无延期。

影响范围与迁移进度实测数据

据速卖通2024年Q2《平台生态健康度报告》披露：截至2024年6月30日，98.7%的活跃第三方服务商（含ERP、物流、选品工具类）已完成向新版AliExpress Open API（v3.0）迁移；中国境内TOP 500跨境ERP中，100%完成接入，平均迁移周期为12.3个工作日（数据来源：速卖通开发者生态白皮书2024，P.27）。未迁移应用在6月30日后无法获取订单、商品、物流轨迹等核心数据，将导致自动发货失败、库存同步中断、售后工单滞留等连锁问题。

新版API关键能力与合规要求

v3.0接口采用OAuth 2.0授权机制，强制要求HTTPS加密传输，并新增实时风控校验（如IP白名单绑定、请求频次令牌桶限流）。根据速卖通API控制台实测基准：单应用QPS上限为50（突发峰值允许100），订单查询响应平均延迟≤320ms（P95值），商品批量上传吞吐量达200条/秒（测试环境，生产环境需按类目分级限流）。所有调用必须携带X-Ae-App-Key与X-Ae-Signature双签名头，签名算法采用HMAC-SHA256（密钥由开发者后台生成，不可复用v1/v2旧密钥）。

常见问题解答（FAQ）

{速卖通API老接口下架时间} 适用于哪些卖家？是否影响已上线应用？

本次下架面向所有曾使用v1/v2接口的主体，无论企业资质（个体工商户/有限公司）、入驻类型（直营店/分销店）或经营区域（中国内地/香港/东南亚仓发）。已上线但未完成v3.0迁移的应用，自2024年6月30日00:00起将完全失效——包括历史授权未过期的应用。速卖通后台“已授权应用”列表中显示为“Deprecated”的应用即属此类，需立即重新申请v3.0凭证并重做OAuth授权流程。

如何确认当前使用的是老接口？迁移前必须做哪些准备？

登录速卖通开放平台→进入“我的应用”→查看“应用详情”页底部“API版本”字段：若显示“v1”或“v2”，即为待迁移对象。迁移前必须完成三步：① 在v3.0控制台创建新应用并获取AppKey/AppSecret；② 按《v3.0接入文档》第4.2节完成OAuth 2.0授权码模式改造（重点处理redirect_uri白名单与scope权限映射）；③ 使用v3.0沙箱环境全链路验证（订单创建→发货→物流回传→评价同步），全部通过后方可切生产流量。

老接口停用后，历史数据能否导出？订单/评价等关键信息会丢失吗？

不会丢失。速卖通明确承诺：v1/v2停用仅终止接口调用能力，所有商家后台数据（含2015年至今订单、评价、纠纷记录）仍可在卖家中心完整查看与导出。但需注意：v1/v2接口特有的历史数据拉取方式（如aliexpress.solution.order.get）已不可用，须改用v3.0对应接口（如/order/query）并按新分页规则（cursor-based）重新获取。建议在6月30日前通过v1/v2最后一次全量同步关键业务数据至本地数据库。

迁移过程中遇到“Invalid Signature”或“Scope Mismatch”错误，如何快速定位？

“Invalid Signature”主因是签名计算错误：务必检查是否使用v3.0专属AppSecret（非v1/v2旧密钥）、是否对参数按字典序排序后拼接、是否对UTF-8编码字符串进行HMAC-SHA256运算（参考文档附录A示例代码）。而“Scope Mismatch”则表明OAuth授权时请求的权限（scope）与应用后台配置的权限不一致，需进入v3.0控制台→应用管理→编辑权限，勾选实际调用接口所需的最小权限集（如仅需查订单，则无需勾选“商品发布”权限）。

对比v3.0，老接口有哪些不可替代的功能？是否支持平滑过渡？

v1/v2接口中部分功能已被v3.0增强替代：原v1的“批量刊登”接口现由v3.0的/product/batch/create承接，支持SKU级多语言描述；原v2的“物流轨迹订阅”升级为Webhook主动推送模式，延迟从分钟级降至秒级。唯一未迁移的功能是v1时代的“店铺装修API”（已归入速卖通商家后台可视化编辑器），官方明确表示不再提供编程式装修接口。平滑过渡可行，但需严格遵循v3.0文档中的“灰度切换方案”：先并行运行双接口（v2读历史数据+v3写新数据），待v3.0全链路稳定7日后，再彻底下线v2调用。

速卖通API升级是强制性技术演进，及时迁移是保障业务连续性的底线要求。