# API 版本管理

### 描述与策略

API 版本管理是指对 API 定义（API Specification）的管理，用于标记一组 API 在某个版本下的状态，API 版本属于管理用字段。在 Apace APISIX 中，我们约定 Route 等同于 API。

处于早期测试版本的 API 是会发生调整的，使用者应当预期到这一情况。一旦 API 发布，若没有特殊情况，不应当被再次修改。若有不向后兼容的修改，应当通知使用者，以确保他/她们能够快速地切换新版本。请注意：通常旧版本接口需要保留一段时间。

### 使用

> 本示例将引导您创建一条路由资源，并为其增加 API 版本，创建后在资源列表页进行搜索、查看。

首先，您需要访问资源列表，接着，点击右侧蓝色**创建**按钮进入创建流程。

![列表页](https://4113110069-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQtZefWebJLMmwRok3p%2F-MR0Jq7oKaM3coEC8yUy%2F-MR0KDdJQxngoESOGwwx%2Fimage.png?alt=media\&token=c4e748a3-5909-4231-a222-ec5d2b7eded9)

![步骤1](https://4113110069-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQtZefWebJLMmwRok3p%2F-MR0Jq7oKaM3coEC8yUy%2F-MR0KKdzogg4Ep6_4XkZ%2Fimage.png?alt=media\&token=071d96a1-1834-4332-8fe6-69f76e5c982f)

在进入创建步骤1后，您需要参考[创建路由](../../guides/route/chuang-jian-lu-you)以补充必要的信息，除此之外，我们将进行**版本**字段的配置：

![](https://4113110069-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQtZefWebJLMmwRok3p%2F-MR37PdW0wMXx7rDzWOm%2F-MR388lH3aHvH_gi7m1m%2Fimage.png?alt=media\&token=e1b7e283-49ff-4f7d-9e5d-45fd61a0d6cf)

点击**版本**输入框，若已存在版本号，将会展示**下拉框**供您选择，如上图所示；若无任何版本号或无您所需的版本号，您需要**手动输入**指定版本号，如 v2：

![](https://4113110069-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQtZefWebJLMmwRok3p%2F-MR38_6ECGDeRtUMkP0i%2F-MR38hdpLiklxADLdvvC%2Fimage.png?alt=media\&token=c80d5521-c5e8-4e29-9b45-2acfa4d8507b)

其它步骤，请参考[创建路由](../../guides/route/chuang-jian-lu-you)，完成所需配置后提交，将返回列表页：

![](https://4113110069-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQtZefWebJLMmwRok3p%2F-MR38tCq2fE8V7ztzSRF%2F-MR396aV5LAVIO6qxBGK%2Fimage.png?alt=media\&token=6b84fc9a-eb50-4709-9361-b3d8b53b9106)

如上图所示，新创建的版本号 v2 在版本字段中显示。

如您需要根据版本号进行搜索，只需点击搜索区域的版本字段，将展示目前已存在的版本列表。如下图所示：

![](https://4113110069-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQtZefWebJLMmwRok3p%2F-MR39IJ8XvZbSxibYPpz%2F-MR39kEqfgBC7ZMIbjcu%2Fimage.png?alt=media\&token=77157f68-507a-4e78-8ba3-42c59896c04e)

在本示例中，选择 v2 并点击右侧搜索按钮，将展示搜索结果：

![](https://4113110069-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQtZefWebJLMmwRok3p%2F-MR39IJ8XvZbSxibYPpz%2F-MR39siBColuU_vxEDXw%2Fimage.png?alt=media\&token=2aabd483-a821-4c15-ad32-c132cb344f7b)

至此，您可以完成 API 版本的管理。
