11.3. URL 版本
如果您具有不同的用于搜索歌曲的端点（通过工件，按歌曲标题等），使用 URL 版本作为 URI 的一部分包括 API 版本，例如：
- api.songs.com/v1/songwriter
- api.songs.com/v2/songwriter
- api.songs.com/v1/song
- api.songs.com/v2/song
- 以此类推
使用此方法时，自 v1 准备对 API 进行版本之后，您应已进行了规划。
然后，3scale 网关将从 URI 中提取端点和版本。这种方法允许您为任何版本/端点组合设置应用计划。然后，您可以将指标与这些计划和端点关联，您可以绘制各个版本上每个端点的使用情况。
以下屏幕截图显示了 3scale 的灵活性。
图 11.1. 版本计划功能
唯一需要做的是进入 3scale 管理门户中的 [your_API_name] > Integration > Configuration，并将您的 URI 映射到您的指标，如下图所示。
图 11.2. 将 URI 映射到指标
您现在有两个不同的 API 版本，各自启用了不同的功能。您对它们的使用具有完全的控制权和可见性。
如果您要与应移至 API v2 的所有用户通信，您可以发送内部备注要求他们这样做。您可以监控谁进行了移动，并了解 v1 上的活动在 v2 活动增加期间如何减少。通过在授权调用中向 3scale 添加指标，您可以看到整体流量到达 v1 与 v2 端点，并了解何时可以安全地弃用 v1。
图 11.3. 版本控制
如果某些用户使用 v1，则只能过滤出那些用户，以发送有关切换到 v2 的另一个内部备注。
3scale 提供三步方法来发送弃用通知。
- 导航到 Audience > Applications > Listing，并根据您要发送弃用备注的应用程序计划过滤列表并点击 Search。
- 单击 multiselector，以选择该特定版本的所有应用。显示新的选项，并允许您执行批量操作，如 发送电子邮件、更改应用程序计划和更改状态。
- 点 Send email，然后按照步骤将弃用通知发送到所选应用程序的所有者。
下图提供了一个可视化参考。
图 11.4. 发送弃用备注
对于对端点发出的每个 authrep 调用，您仅进行身份验证一次，但为端点报告两次，一次报告一次用于 API 版本。没有可重复性，因为调用只能一次被验证。对于您对特定 API 版本的任何端点进行的调用，您可以将点击聚合到以版本号（v1、v2 等）命名的方便指标上，您可以使用它来相互比较完整的版本流量。
