一、swagger.json 的作用

Swagger.json 是一种 API 文档的标准格式，它可以用来描述 RESTful API 的接口，包括接口的请求方式、参数、返回值等信息。它可以方便地帮助开发人员更快地定义和维护 API 接口，使得 API 接口的管理变得更加高效。

二、ASP.Net Core2.1 WebAPI 根据 swagger.json 自动生成客户端代码

ASP.Net Core2.1 WebAPI 根据 swagger.json 自动生成客户端代码，可以让开发人员更快地实现 API 接口的调用，并且可以帮助开发人员更好地管理 API 接口。

首先，需要在 ASP.Net Core2.1 WebAPI 中添加 Swagger 的服务，添加完成后，可以在浏览器中访问 swagger.json 文件，其中包含了 API 接口的相关信息。

然后，可以使用 Swagger Codegen 工具根据 swagger.json 文件生成客户端代码。Swagger Codegen 可以根据 swagger.json 文件生成不同语言的客户端代码，包括 Java、Python、C#、PHP 等等。

下面是一段使用 Swagger Codegen 生成 C# 客户端代码的示例：

swagger-codegen generate -i http://petstore.swagger.io/v2/swagger.json -l csharp -o ./csharp-client
Shell

上面的命令行可以从 Swagger.json 文件中获取 API 接口的信息，然后使用 C# 语言生成客户端代码，并将代码输出到 csharp-client 文件夹中。

三、客户端代码的使用

生成完成的客户端代码可以帮助开发人员更加方便地调用 API 接口，可以根据自己的需要对客户端代码进行修改和定制。

客户端代码的使用非常简单，只需要将客户端代码引入到自己的项目中，然后就可以使用 API 接口了。

例如，在 C# 中，可以使用如下代码来调用 API 接口：

var client = new PetStoreClient();var response = client.GetPets();
C#

上面的代码可以帮助开发人员更快地调用 API 接口，而不需要自己编写代码来实现 API 接口的调用。