給軟體開發人員的 OpenAPI (Swagger) 規格

Contents

用於高效 API 設計、文件、開發和測試的 OpenAPI (Swagger) 規格學習指南

從這 2.5 小時的課程，你會學到

OpenAPI 及其優勢概述。您將從頭開始了解 OpenAPI。您將知道為什麼需要使用 OpenAPI。
了解 OpenAPI 規範的結構。您將掌握結構並成為 Swagger 或 OpenAPI 文件的專家。
逐步創建 OpenAPI 文件。您將學習從頭開始創建新的 OpenAPI 規格。
許多可下載的 PDF：OpenAPI 結構思維導圖、OpenAPI 快速指南、HTTP 狀態程式碼備忘單、完整的 OpenAPI 規格文件。
Swagger 和 OpenAPI 之間的區別。您將清楚地了解兩者，並且永遠不會混淆這兩個術語。
練習作業，應用您從本課程中學到的知識，開始游刃有餘地在實戰專案中實踐。

要求

RESTful Web 服務的基本知識，以了解 HTTP 請求的不同組件。
JSON 的基本知識會有所幫助。

課程說明

學生的反饋：

“很棒的課程！！為初學者很好地解釋了概念”——Asamoah Emmanuel

“這是一門令人興奮的課程，其明確目標是教授如何記錄基於 OpenAPI 架構的 API。專注於邊做邊學，並提供關於在 OpenAPI 協議下建構 API 時要考慮的元素的深刻見解。很高興參加這個課程： )” — Sergio Hidalgo

“清晰的討論和得到有力支持的建議。” — James Smith

“到目前為止，一切都很好。出色的方法，Praveen 的教學明瞭清楚、精確的，而且內容很容易理解。” —John Anderson

“課程簡短而切中要點。課程佈局合理且易於理解。” — Riaan du Toit。

“清晰的說明和視頻簡短而切題。謝謝。” — Sujitha Palanivel。

課程更新歷史：

2022 年 6 月：新！ PDF下載 – OpenAPI 3.0.3結構思維導圖

2022 年 1 月：新！為路徑部分添加了練習活動。

2021 年 11 月：新！添加練習活動以應用您的知識。

2021 年 7 月：新！為“與學生合作”部分添加了作業解決方案（30 分鐘）

2021 年 1 月：新！ PDF 下載 – HTTP 狀態程式碼快速指南

2020 年 12 月：新！ PDF 下載 – 22 頁 OpenAPI 快速指南

OpenAPI 規格或 Swagger 規格是定義 RESTful API 最流行的規範。在開發環境中，使用 OpenAPI 來記錄 API 端點的情況有所增加。 Postman、Google、Microsoft 和 Oracle 等公司都是 OpenAPI 的成員。本課程將教您從頭開始建構 OpenAPI 規格。

我叫 Praveen，我是這門課程的講師！我在 Honeywell, 工作了大約十年，在 C# .NET 開發方面，我從軟體工程師轉變為高級軟體工程師、技術主管等。在過去的六年裡，我一直從事基於 .NET 技術的訪問控制產品的安全領域工作。此外，我已經發布了超過 15 門關於各種 .NET 技術的課程。

本課程涵蓋的主題

OpenAPI 及其優勢概述。您將從頭開始了解 OpenAPI，而無需事先了解它。
了解 OpenAPI 規格的結構。您將掌握它的形式並成為理解任何 Swagger 或 OpenAPI 文件的專家。
逐步創建 OpenAPI 文件。您將學習從頭開始創建新的 OpenAPI 規格。
許多可下載的 PDF，包括：
- OpenAPI 結構思維導圖
- OpenAPI 快速指南
- HTTP 狀態程式碼備忘單
- 本課程中使用的 OpenAPI 規格文件等。
Swagger 和 OpenAPI 之間的區別。您將對兩者有一個清晰的了解，並且永遠不會與這兩個術語混淆。
練習作業以應用您的學習來掌握您在本課程中學到的所有概念。開始實戰專案工作時，您會感到非常自在。