版本控制

当前 API 版本: 2022-08-10

API 请求需要 version 参数采用格式为 version=YYYY-MM-DD 的日期。随每个 API 请求一起发送 version 参数。

我们以向后不兼容的方式更改 API 时，会发布一个新的次版本。要利用新版本中的更改，请将 version 参数的值更改为新日期。如果尚未准备好更新到该版本，请勿更改版本日期。

版本日期的不推荐调度

发布新版本日期时，先前版本日期将进入一个为期一年的弃用期。在使用已引退版本的 API 请求自动切换到可用的最新版本之前，您将有一年时间迁移代码以支持不推荐使用的版本。

以下时间线提供了 2019-06-04 版本的废弃调度期间可能发生的情况的示例。

2019-07-12 版本日期已发布。这将开始对持续一年的先前 2019-06-04 版本日期进行不推荐使用期。
- 在不推荐使用期间，仍可使用不推荐使用的版本日期。
在弃用期间将发布新的版本日期，例如 2020-05-10。
2020 年 7 月 12 日， 2019-06-04 版本日期的废弃时间段结束，版本日期已作废。
- 在 2020 年 7 月 12 日之后仍使用 2019-06-04 版本日期的 API 请求将自动更改为使用可用的最新版本日期的行为。对于此示例，可用的最新版本为 2020-05-10。

下表显示了每个版本日期的服务行为更改。切换到较新版本日期将会激活较早版本中引入的所有更改。

版本日期	更改汇总	停用日期
`2022-08-10`	使用新模型扩展实体的语言，以提高准确性和置信度分数。版本 2 俄语实体类型系统。版本 2 瑞典语实体类型系统。
`2022-04-07`	V 2 类别类型系统的错误修订。
`2020-12-09`	版本 2 英语实体类型系统。
`2020-12-02`	版本 2 韩国语实体类型系统。 V 2 西班牙语实体类型系统。
`2020-08-01`	旨在实现缺省分类法中标签名称标准化的分类法更改。
`2019-07-12` 不推荐	新的英语实体模型，提高了准确性和置信度分数。	2021 年 8 月 1
`2019-06-04` 不推荐	修复了一个错误，该错误导致使用定制模型的实体请求忽略了 `limit` 选项。对于所有模型，所有实体请求的缺省 `limit` 值现在为 50。已除去最大 `limit` 值 250 个实体。	2020 年 7 月 12 日
`2018-11-16` 不推荐	V2 意大利语实体类型系统。	2020 年 7 月 12 日
`2018-09-21` 不推荐	V2 葡萄牙语实体类型系统。	2020 年 7 月 12 日
`2018-03-16` 不推荐	V2 法语实体类型系统。 V2 德语实体类型系统。	2020 年 7 月 12 日
`2017-02-27` 不推荐	基本版本。	2020 年 7 月 12 日