备注：（swagger/index.html）(部署参考IIS：https://www.cnblogs.com/become/p/15796204.html)

对于C# 开发人员，接口服务大部分是WCF（需要配置很多），WebService(走的XML，相比json同样的内容大很多) ，一般应用程序（大量接口可能会有点麻烦），WebAPi则借鉴了以上的有点，屏蔽了缺点，而且调试也可以完全摆脱PostMan;

一、.NetCore WebApi项目开发Demo

接下来我新增一个（开发工具VS2019）

1，新增项目

1、安装Nuget包（项目/管理NuGet包）

（主要安装两个，一个为了展示所有接口，一个为了展示接口XML注释）

Microsoft.Extensions.PlatformAbstraction

Swashbuckle.AspNetCore

 public void ConfigureServices(IServiceCollection services)
            services.AddControllers();
            services.AddSwaggerGen(c =>
                c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
            #region 
            var basePath = PlatformServices.Default.Application.ApplicationBasePath;
            //var basePath = AppDomain.CurrentDomain.BaseDirectory;
            //Core.Admin.webapi.xml是我的项目生成XML文档的后缀名,具体的以你项目为主
            var xmlPath = Path.Combine(basePath, "WebApiDemo.xml");
            //第二个参数为true的话则控制器上的注释也会显示(默认false)
            c.IncludeXmlComments(xmlPath, true);
            #endregion
 public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
            if (env.IsDevelopment())
                app.UseDeveloperExceptionPage();
            app.UseRouting();
            app.UseAuthorization();
            app.UseEndpoints(endpoints =>
                endpoints.MapControllers();
            app.UseSwagger();
            app.UseSwaggerUI(c =>
                c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <!-- To customize the asp.net core module uncomment and edit the following section. 
  For more info see https://go.microsoft.com/fwlink/?linkid=838655 -->
  <system.webServer>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
    </handlers>
    <aspNetCore processPath="dotnet" arguments=".\WebApiDemo.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess">
      <environmentVariables>
        <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
      </environmentVariables>
    </aspNetCore>
  </system.webServer>
</configuration>
<!--ProjectGuid: 9c4de816-3c21-4e93-8199-4af60a501822-->
访问即可解决
测试结果如下：http://127.0.0.1:1111/swagger/index.html
 postman测试
 三、设置返回报文节点显示样式
 Startup类
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.PlatformAbstractions;
using Microsoft.OpenApi.Models;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text.Json;
using System.Threading.Tasks;
namespace WebApiDemo
    public class Startup
        public Startup(IConfiguration configuration)
            Configuration = configuration;
        public IConfiguration Configuration { get; }
        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
            services.AddControllers();
            services.AddSwaggerGen(c =>
                c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
                #region 
                var basePath = PlatformServices.Default.Application.ApplicationBasePath;
                //var basePath = AppDomain.CurrentDomain.BaseDirectory;
                //Core.Admin.webapi.xml是我的项目生成XML文档的后缀名,具体的以你项目为主
                var xmlPath = Path.Combine(basePath, "WebApiDemo.xml");
                //第二个参数为true的话则控制器上的注释也会显示(默认false)
                c.IncludeXmlComments(xmlPath, true);
                #endregion
            services.AddControllers()
                .AddJsonOptions(options =>
                    //json循环最大深度 如果你所需的资源确实超过了32层，可以加深深度来解决
                    options.JsonSerializerOptions.MaxDepth = 64;
                    //设置无值节点是否显示（true不显示，false显示）   
                    options.JsonSerializerOptions.IgnoreNullValues = false;
                    //为null,返回节点和属性大小写相同
                    options.JsonSerializerOptions.PropertyNamingPolicy =null;
                    //为JsonNamingPolicy.CamelCase返回节点为小驼峰
                    //options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase; 
        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
            if (env.IsDevelopment())
                app.UseDeveloperExceptionPage();
            app.UseRouting();
            app.UseAuthorization();
            app.UseEndpoints(endpoints =>
                endpoints.MapControllers();
            app.UseSwagger();
            app.UseSwaggerUI(c =>
                c.SwaggerEndpoint("../swagger/v1/swagger.json", "My API V1");