匯出時的轉換
當以不支援的格式匯出使用 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 時才會匯出。如果不包含,則會忽略 服務條款 欄位,以確保定義的有效性。