22、使用 React 和微服务构建 CRM 系统

使用 React 和微服务构建 CRM 系统

1. 使用 Swagger 设计 REST API

在开发基于 REST 的应用程序时，Swagger（https://swagger.io）是一个非常有用的工具。它具有许多特性，可用于创建 API 文档、生成 API 代码以及测试 API。

我们将使用 Swagger UI 来构建一个用于检索人员列表的 API 原型，并生成相应的文档。虽然可以从 Swagger 生成代码，但我们将利用该工具来确定最终 REST 调用的形式，然后使用之前创建的数据模型自行实现。这样做有两个原因：一是可以创建简洁的数据模型，通过原型可视化模型；二是生成的代码量通常很大，自行编写代码更容易将数据模型与数据库关联起来。

以下是使用 Swagger 设计 API 的具体步骤：
1. 登录 Swagger ：从主页点击“Sign In”，选择登录到 SwaggerHub（用于开发 API）或 Swagger Inspector（用于测试 API）。如果没有 Swagger 账户，可以在此处注册或使用 GitHub 账户登录。
2. 创建新 API ：选择“Create New > Create New API”，在模板下拉菜单中选择“None”并填写相关信息。
3. 填充 API 信息 ：初始的 API 结构如下：

swagger: '2.0'
info:
  version: '1.0'
  title: 'Advanced TypeScript 3 - CRM'
  desc