匯出時的轉換
上次更新：2026/10/20當將使用 API Contracts 功能設計的定義匯出為不支援這些功能的格式時，該定義會被修改以符合目標格式。在此過程中會失去部分表達能力。
下表說明匯出為下列規格之一時，對您的 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 時才會匯出。如果沒有，將會忽略 服務條款 欄位，以確保定義的有效性。