OpenAPI 規範與 Swagger

Swagger 提供最容易使用的工具，以充分利用 OpenAPI 規範 (OAS) 的所有功能。

將 OAS 新增至您的 API Swagger Inspector 可讓您在幾秒鐘內為任何 API 產生 OAS 定義 了解更多 使用 OAS 設計 API 在具有內建驗證的編輯器中設計 API，以便更快地設計並減少錯誤 了解更多 使用 OAS 記錄 API 直接從您的 OAS 定義建立開發人員喜歡使用的 API 文件 了解更多 維護 OAS 定義 使用 SwaggerHub 為您的所有 API 團隊提供中央儲存庫 了解更多

什麼是 OpenAPI 規範？

OpenAPI 規範，以前稱為 Swagger 規範，是定義 RESTful 介面的世界標準。OAS 使開發人員能夠設計一個與技術無關的 API 介面，作為他們 API 開發和使用的基礎。

了解更多

What is the OpenAPI Specification
使用 SwaggerHub 標準化 OAS

SwaggerHub 可協助需要設定和實施 API 樣式指南，並更好地協同工作的團隊。掌控您的 API 設計流程，並使用 OAS 和 SwaggerHub 幫助您的團隊交付開發人員喜歡使用的 API。

了解更多

Standardize on OAS with SwaggerHub

從程式碼產生 OAS

如何從完全開發的 API 取得 OpenAPI 檔案？透過 Swagger Inspector，您可以從任何 API 端點自動產生定義，而無需任何手動接線。產生只需不到 3 次點擊，並讓您的開發團隊充分利用定義來產生進一步的文件和 SDK。

查看 Swagger Inspector

Generating OAS From Code
OAS 與 Swagger

談論 OAS 不能不談論 Swagger。SmartBear 的 Swagger 專案是 OAS 的原始基礎，包括 Swagger 規範和 Swagger 工具。Swagger 社群正在帶領建立工具，以在整個 API 生命週期中充分利用 OAS 的強大功能。

Swagger 開源工具

OAS and Swagger

API 設計資源

文章 API 設計最佳實務 良好的 API 設計是團隊在試圖完善其 API 策略時經常出現的話題。 網路研討會 OpenAPI 3.0：如何使用最新的 OpenAPI 規範設計和記錄 API OpenAPI 3.0 基於原始的 Swagger 2.0 規範，已成為世界標準... 文件 OpenAPI 規範文件 檢視 OpenAPI 規範的文件

充滿信心地擴展您的 API 設計

設計

根據基於規範的標準設計和建模 API

建置

為幾乎任何語言的 API 建置穩定、可重複使用的程式碼

文件

透過互動式 API 文件改善開發人員體驗

測試

在沒有額外負擔的情況下，對您的 API 執行簡單的功能測試

標準化

在您的 API 架構中設定和實施 API 樣式指南