Swagger and the OpenAPI Specification

• 对 REST API 的基本了解
• 使用 JSON 或 XML 格式的经验
• 面向物件的程式设计体验

观众

• 后端开发人员

Swagger 是一个开源工具框架，使用开放 API 规范 （OAS） 档案来构建、设计、记录和使用 RESTful Web 服务。

此讲师指导的即时培训（在线或现场）面向 希望使用 Swagger 构建、设计、记录和使用 RESTful Web 服务的后端开发人员。

在本次培训结束时，参与者将能够：

• 为软体基础架构创建 API 管理策略。
• 使用 Swagger 工具编辑 OAS 档案和创建 SDK。
• 实施 API 安全性、版本控制、文件和其他重要 功能。

课程形式

• 互动讲座和讨论。
• 大量的练习和练习。
• 在即时实验室环境中动手实施。

课程自定义选项

• 要申请本课程的定制培训，请联系我们进行安排。

介绍

API 定义

• 定义档
• API 请求

YAML

• 什么是YAML
• YAML 规则

RESTful 服务概述

• 资源
• 状态传输
• 代表

准备开发环境

• 安装和设定 Swagger
• 安装和配置 Node.Js

REST Web 服务约束体系结构

• 使用 client-server 约束
• 使用统一的介面约束
• 使用无状态约束
• 使用 HTTP 快取
• 启用层次系统

REST API 设计

• 实施 CRUD 操作
• 使用错误处理
• 实现 REST API 的操作
• 处理 API 中的更改
• 版本控制 API
• 快取 API
• 支援分页和部分回应

使用 Swagger 的规格

• 使用 Swagger 编辑文件
• 以 YAML 格式创建规范
• 创建路径和观测值
• 添加文件
• 向 OAS 档添加 Schema
• 使用 SwaggerHub

API Management

• 创建 API 管理策略
• 管理 API 生命周期
• 生成 API 代理
• 控制 API 的行为
• 构建 API 门户
• 提供流量管理

API 安全

• 使用令牌和 JWT 进行保护
• 使用 API 金钥和金钥进行保护
• 使用 OAuth2.0 进行授权

总结和结论