导出时的转换
上次更新日期：2026/10/9当以不支持 API 契约 功能的格式导出使用这些功能设计的定义时，该定义会被修改以适应目标格式。 在此过程中会损失部分表达能力。
下表描述了导出为以下规范之一时对您的 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 时才会将其导出。如果不符合要求，将忽略 服务条款 字段，以确保定义的有效性。