使用 Swagger 和 OpenAPI 设计 API，视频版

Designing APIs with Swagger and OpenAPI, Video Edition

 视频说明

在 Video Editions 中，叙述者阅读书籍，同时内容、图形、代码列表、图表和文本显示在屏幕上。就像有声读物一样，您也可以作为视频观看。

从概念到生产，跟随真实的 API 项目，并动手学习如何使用 OpenAPI 描述和设计 API。

在使用 Swagger 和 OpenAPI 设计 API 中，您将学习如何：

• 了解 OpenAPI 语法和结构
• 使用 Swagger 和其他工具创建 OpenAPI 定义
• 设计认证和授权
• 将 OpenAPI 描述转换为在线文档
• 自动化流程和生成代码
• 使用用户故事迭代 API 设计
• 针对模拟服务器构建前端
• 使用 Swagger Codegen 生成后端代码
• 对 API 进行版本控制并躲避重大更改
• 与跨职能团队合作

使用 Swagger 和 OpenAPI 设计 API 是一份全面的指南，介绍如何使用最广泛采用的标准来设计和描述您的第一个 RESTful API。按照 Swagger 核心贡献者 Josh Ponelat 和 API 顾问 Lukas Rosenstock 的专家指导，您将在每一章中逐步扩展您希望在现实世界中构建的 API 类型。您将利用 OpenAPI 和 Swagger 来帮助自动化您的工作流程，并腾出时间开发更多令人兴奋的功能。了解 OpenAPI 定义的语法和结构，使用常用工具创建和迭代 API 设计，并向公众发布您的 API。

 关于技术
创建客户和开发人员都会喜欢的 Web API！使用 Swagger（用于定义和记录 REST API 的工具集合），您将构建对软件的安全、受控的访问。由于 Swagger 实施了供应商中立的 OpenAPI 规范，因此您将按照 Google、Microsoft 和 Amazon 采用的相同标准进行构建。

 关于本书
使用 Swagger 和 OpenAPI 设计 API 引入了一种设计优先的方法。它专为刚接触 API 设计的开发人员编写，遵循 API 项目从概念到生产的生命周期。您将通过逐步完成的示例来探索 API 的注意事项。您将获得针对特定业务需求设计 API、使用开源工具生成文档以及构建开发人员友好型组件（如模拟和客户端 SDK）的实践经验。

 里面有什么

• OpenAPI 语法和结构
• 使用 Swagger 创建 OpenAPI 定义
• 自动化流程和生成代码
• 与跨职能团队合作

 关于读者
对于 Web 开发人员。无需事先了解 Swagger 或 OpenAPI。

 作者简介
Josh Ponelat 是 SmartBear 的 Swagger 开源负责人。Lukas Rosenstock 是一名独立的软件开发人员和 API 顾问。