升级指导

升级指南

目前仍在调用 2021-08版本（已弃用）API 的应用，将会自动切换至我们最旧稳定版本 2023-10。然而，为确保您的应用能够平稳运行，我们强烈建议您尽快过渡到最新稳定版本 API。当前最新的稳定版本为 2024-10。我们建议您密切关注新版本发布的更新日志和功能说明，以便及时调整应用并利用新特性和性能优化。

了解 2024-10 发行版本 更多信息

API 版本变更

您需要通过修改 URL 中的版本号来指定所需使用的 API 版本。具体格式如下：

RESTful API URL： /openapi/{version}/{endpoint}

例如，调用 2024-10 版本 API 时，URL 格式如下：

RESTful API URL： /openapi/2024-10/products

Webhook 版本变更

API 版本的更改不会自动更新您的 Webhook 负载序列化所使用到的 API 版本。您还需要手动同步更新应用配置的 API 版本，以保持 Webhook 负载的序列化与最新稳定版本兼容。我们建议始终使用最新稳定版本，以确保与 API 保持一致性。

私有应用 API 版本变更步骤：

1. 登录管理后台；

2. 进入 “应用中心”；

3. 选择 “私有应用”；

4. 找到您的私有应用并更新 API 版本。

公有应用 API 版本变更步骤：

对于公有应用，您需要联系平台管理员或负责人来更新应用版本。平台管理员将协助完成版本更新及其他配置调整。

注意事项请了解 Webhook 信息

通过以上步骤，您可以平滑过渡到最新的 API 版本，确保应用在新版本中继续稳定运行，并获得最新的安全性和功能更新支持。