OpenAPI: 從初學者到大師

Contents

掌握 OpenAPI (原 Swagger) ，為你的 APIs 建立規範( specifications )

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

學習使用 OpenAPI 規範定義 APIs
用 Swagger UI 建立很棒的 API 文件
在 Swagger Hub 編輯 OpenAPI 規範

要求

能夠編輯文字檔案( text files )
掌握 RESTful APIs 和 JSON 的知識將很有幫助

課程說明

Openapi 3.0 是 APIs 文件化的領先工具。

以前稱為 Swagger，OpenAPI 有著悠久的歷史。在 2010 年，Swagger 作為一個開源規範開始設計和記錄 RESTful APIs。

2015年，Swagger 專案被 SmartBear 軟體公司收購。該 Swagger 規範捐贈給 Linux 基金會，並重新命名為 OpenAPI。

OpenAPI 規範是蓬勃發展的開源社群的基石。只要搜尋 OpenAPI 工具，你就可以找到轉換器( converters )、文件( documentation )、驗證器( validators )、編輯器( editors )、模擬伺服器( mock servers )、測試工具( testing tools )等等！根據 OpenAPI 規範，你可以為超過 50 種語言生成客戶端原始碼。你可以為超過 40 種不同的語言生成伺服器端程式碼。

所有這些開源貢獻從 OpenAPI 規範開始，我們將在本課程深度探討。

你將從學習什麼是 API 起始，複習 HTTP 協議並瞭解其對應 RESTFul APIs 如何使用。

然後我們開始談 OpenAPI，並教你如何將其應用到 RESTFul APIs 的文件紀錄。

接著我們採用 Swagger Hub 寫 OpenAPI 規範。

Swagger Hub 是免費的，Swagger 和 OpenAPI 規範的好用線上編輯器。

你將學會為一台 RESTful 網路伺服器創立一個完整的 OpenAPI 規範。

一步一步的，你將瞭解如何：

在 Swagger Hub 中編輯 OpenAPI 規範
在 YAML 中定義 OpenAPI 規範
新增開發人員資訊
新增伺服器資訊
定義一個 API 路徑( path )
定義一個 API 操作
使用 JSON schema 約束建立健壯的物件
通過可重複使用的元件提高規範的品質
定義查詢參數
定義路徑( path )參數
定義 GET、 PUT、 POST 和 DELETE 操作
建立 API 安全 schemas
使用 OpenAPI Code Gen 生成原始碼
使用 ReDoc 生成健壯的 API 文件
使用 Apache Maven 從 OpenAPI Code Gen 生成程式碼

本課程有大量的作業和實際操作的例子，可以讓你輕鬆地編寫 OpenAPI 規範。

今天就註冊吧，看看為你的 RESTFul APIs 使用 OpenAPI 是多麼容易！

目標受眾

需要使用 OpenAPI 規範的任何人
需要編寫 APIs 文件的開發人員
負責 API 規範的商業分析師

講師簡介

John Thompson Spring Framework 大師- 暢銷導師( 更多講師主講課程介紹 )

嗨，我是 John。

我在 IT 行業已經幹了20多年了。今天，我主要專攻 Java，這是當今最成功、最廣為人知的程式語言。我還專攻 Spring Framework，它是在 Java 平臺上建構企業級應用程式的最流行的開源應用程式框架。我曾經合作過的一些組織包括 Visa，Kohls，Federal Home Loan Bank 和 Belk Department Stores。

通過我提供的課程，我希望利用我多年的經驗來加速你對 Spring 框架的學習。我不想對你撒謊。 Spring 框架是一個大框架。企業級 Java 的環境甚至更大。如果你是 Java 的新手，你需要學習很多東西。我希望通過這個網站上的內容，能夠加速你對 Java 和 Spring 的瞭解。