【代替Swagger和Postman等工具的神器】使用VS自带的.http文件快速调试webapi

前言：需要VS2022版本支持。.http文件在.NET 8环境下自带，但是处于好奇心挖掘了一下，其实这个文件和你是啥SDK环境无关、和啥开发语言也无关，纯粹就是VS2022里面附带的功能。废话不多说，下面正文：

创建webapi项目(任意.NET版本)，此处用.NET6开发一个带有控制器的webapi项目，用来测试使用。

然后创建一个新的api控制器，并写几个简单的测试api：

[Route("api/[controller]/[action]")]
[ApiController]
public class TestController : ControllerBase
{
    [HttpGet]
public IActionResult Get1()
    {
return Ok("Hello Get!");
    }
    [HttpPost]
public IActionResult Post1()
    {
return Ok("Hello Post!");
    }
    [HttpPost]
public IActionResult Post2([FromBody] TestParamInfo info)
    {
        TestReturnInfo returnInfo = new TestReturnInfo();
        returnInfo.name = info.name;
        returnInfo.message = $"这家伙年纪{info.age}";
return Ok(returnInfo);
    }
}
public class TestParamInfo
{
public string name { get; set; }
public int age { get; set; }
}

public class TestReturnInfo
{
public string name { get; set; }
public string message { get; set; }
}

为了方便调试，写死启动地址和端口：127.0.0.1:16888

任意创建一个项目，例如控制台项目,为了证明和.NET 8无关，此处也使用.NET 6环境。

在控制台项目下，新建一个http文件

写第一个Get1()的测试内容：

@Url是自定义的变量名，后面url地址接上面配置的写死的地址，然后编写Get访问调试命令，如果没问题，会自动弹出"发送请求"和"调试"链接。

调试会自动运行你当前的启动项目，并访问api；发送请求用于已经有api，我们要测试结果和连通性使用，该功能用于代替postman和swagger，以及.NET 8后面的AOT功能不能支持swagger时候使用，提高调试效率。

测试第一个Get1()接口，效果如图所示

编写访问Post请求用例，并发送请求。Post前面就用Post，Get就用Get，其他的就用对应的。不过需要注意的是，每个用例之间，需要用###注释分割开，不然可能会识别错误，把没有分割开的内容识别为参数。

带实体类参数的用例，并查看访问结果。需要提供必需的头部信息：

Content-Type

需要要调试的参数，以指定格式(例如Json)在下一行直接输入。

需要空白一行输入，否则可能解析出错。

如果把api服务关闭，点发送就自然会失败：

虽然该功能在.NET 8才出来介绍，但是实际上不需要区分.NET SDK，也可以使用，例如我上面的测试环境都是.NET 6环境，也可以用。这是因为.http是VS2022的功能之一，而不是SDK的。如果需要了解更多信息，可以查阅微软官方文档：

https://learn.microsoft.com/zh-cn/aspnet/core/test/http-files?view=aspnetcore-8.0

如果觉得有帮助，欢迎点赞转发或在看~ 当然，也欢迎扫码关注本公众号【Dotnet Dancer】，不定时更新.NET文章，或者一些其他好玩的内容。