导出时的转换
当以不支持的格式导出使用 API Designer 功能设计的定义时，系统会修改该定义以适应目标格式。在此过程中会丢失一些表现力。
下表描述了在以以下规范之一导出时对 API 定义所做的修改：
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| 不支持的功能 | 转换 |
|---|---|
| 组件 | 组件会被复制到使用它的每个位置。 |
| 响应范围和默认响应 | 响应被移除。 |
| Bearer 身份验证和 OpenID Connect | 安全方案被移除。 |
| allOf 组合 | 该组合被替换为包含所用所有类型的所有属性的对象。 |
| anyOf 和 oneOf 组合 | 该组合被替换为空对象。 |
| 多个端点 | 第一个发布的端点包含在定义中，其他端点被忽略。 |
OpenAPI Specification 3.0 仅支持在 服务条款 字段中使用 URL。在以 OAS 3.0 导出定义时，仅当该字段包含 URL 时才会导出。如果不包含，则忽略 服务条款 字段以确保定义的有效性。