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