第 4 章 如何编写 OpenAPI 文档以用作 3scale OpenAPI 规格

ActiveDocs 是 OAS 的实例。使用 ActiveDocs 时，您不必运行自己的 OAS 服务器，或处理互动文档的用户界面组件。交互式文档可从您的 3scale Developer Portal 提供并呈现。

3scale 2.8 引入了 OAS 3.0，在 ActiveDocs 中支持有限。这意味着，一些使用 ActiveDocs 的功能（如自动完成）还没有完全集成，因此在创建新帐户时 3scale 默认为 OAS 2.0。有关 OAS 3.0 和 ActiveDocs 的详情，请参考 第 2.1 节 “3scale 的 OpenAPI 规格 3.0 使用”。

如果您已经有 API 的 OAS 兼容规格，可以在 Developer Portal 中添加它。请参阅 ActiveDocs 配置中的教程。

3scale 通过几种方法扩展 OAS，以适应开发者门户互动 API 文档所需的特定功能：