|
所在平台: Udemy |
课程主页: https://www.udemy.com/course/learn-swagger-and-the-open-api-specification/
课程评论：没有评论
**课程名称：** 学习 Swagger 与 OpenAPI 规范 **课程概述：** 本课程面向对 REST 和 JSON 有基本了解，但非软件开发者的技术人员（如项目经理、API 产品经理、技术文档撰写者），旨在介绍 OpenAPI 规范（常被称为“Swagger”）及其生态工具。OpenAPI / Swagger 是定义 RESTful API 的流行方式，可以用于生成精密的 API 文档、多种语言的 SDK，以及进行自动化测试。 **课程涵盖内容：** * OpenAPI 规范 (OAS) 文件的用途 * YAML 文件格式 * 创建 OAS 文件的方法 * API 安全性定义 * 添加 API 文档 * 使用 JSON 编写 OAS 文件 * Swagger 和 OAS 的替代方案 **课程不涵盖内容：** * 在自有服务器上设置 Swagger * 修改 Swagger 开源代码 **课程形式与时长：** 课程包含视频讲座和 **8 个实践练习**。实践练习至关重要，将引导学员逐步创建 API 定义文件，并通过一个包含真实商业 API 文档的最终项目，从零开始创建文件。预计投入至少 **4 小时** 完成练习。此外，课程还提供一份关于 OAS、Swagger 及替代方案的学习资源文档。 **重要提示：** 本课程主要使用 OAS **2** 版本。虽然 OAS 3 版本正在普及，但许多公司仍在使用 OAS 2。课程中包含关于 OAS 2 和 OAS 3 之间差异的讲座。
The OpenAPI Specification (often called "Swagger") is currently the most popular way to create definitions of RESTful APIs. With these definitions, you can create sophisticated, autogenerated documentation, generate SDKs in several languages, and do automated testing. Swagger is a set of open source tools that use these Open API Specification definition files.This class is for people in the software industry who are fairly technical, but are not software developers: for example, project managers, API product managers, and technical writers. It assumes that you understand REST and JSON, but that's about all. It is meant to be for people who are new to the Open API Specification and Swagger, rather than for experts. It covers:What you can do with OpenAPI Specification (OAS) filesThe YAML file formatHow to create an OAS fileHow to specify securityHow to add documentationHow to write an OAS file in JSONAlternatives to Swagger and OASThis class does not cover:How to set up Swagger on your own serverHow to modify Swagger open source codeIn addition to videos, this course contains 8 hands-on exercises that lead you step-by-step in creating an API definition file, including a final project where you create a file from scratch using documentation from an actual commercial API. It also contains a document with resources on learning more about OAS, Swagger, and alternatives.In addition to the video lectures, expect to spend at least 4 hours doing the exercises. These exercises are key to understanding Swagger and OAS.Important: The course uses OAS 2. A newer version, OAS 3, is starting to be used more, but many companies are still using OAS 2. There is a lecture that points you to the differences between OAS 2 and OAS 3.
