Swagger 是个好东西，对于前后端分离的网站来说，不仅是提高前后端开发人员沟通效率的利器，也大大方便了后端人员测试 API。有时候，API 中可能需要在 Header 中设置认证参数，比如 authToken，这样的功能我们通常是使用 ActionFilter 实现的，这就会导致 swagger UI 中缺少 authToken 字段，下面就来介绍解决这个问题的办法。 创建一个过滤器类，内容如 ...
2016-12-17 00:40 1 5310 推荐指数：
WebApi写好之后，在线帮助文档以及能够在线调试的工具是专业化的表现，而Swagger毫无疑问是做Docs的最佳工具，自动生成每个Controller的接口说明，自动将参数解析成json，并且能够在线调试。 那么要讲Swagger应用到Asp.net Core中需要哪些步骤，填多少坑 ...
Swagger大家都不陌生，Swagger (OpenAPI) 是一个与编程语言无关的接口规范，用于描述项目中的 REST API。它的出现主要是节约了开发人员编写接口文档的时间，可以根据项目中的注释生成对应的可视化接口文档。 OpenAPI 规范 (openapi.json) OpenAPI ...
一、控制器描述 创建一个过滤器类 AuthTagDescriptions，内容如下： 更改Swagger配置文件 效果： ...
[已解决][Asp.net core] 项目使用 Swagger UI 5.0.0-rc5, 无法将 Bearer token 添加Authentication Header. useful links github issure: https://github.com ...
之前的博文 ASP.NET Core中显示自定义错误页面 中的方法是在项目中硬编码实现的，当有多个项目时，就会造成不同项目之间的重复代码，不可取。 在这篇博文中改用middleware实现，并且放在独立的项目中发布成NuGet包，项目中使用时只需安装NuGet包，然后在Startup ...
在 ASP.NET Core 中，默认情况下当发生500或404错误时，只返回http状态码，不返回任何内容，页面一片空白。 如果在 Startup.cs 的 Configure() 中加上 app.UseStatusCodePages(); ，500错误时依然是一片空白（不知为何对500错误 ...
根据我的经验，通常在API中记录请求和响应。这样做可以帮助开发人员调试问题并提供有价值的性能指标。在本教程中，我将介绍如何为ASP.NET Core 3 Web API创建基本的日志记录解决方案。在这篇文章的结尾，我们将有一个有效的日志记录解决方案，它将记录每个请求以及对控制台和文件系统的响应 ...
路由约束 ASP.NET Core中，通过定义路由模板，可以在Url上传递变量，同时可以针对变量提供默认值、可选和约束。 约束的使用方法是在属性路由上添加指定的约束名，用法如下： 框架内部已经提供了一些约束，如下所示： 约束 示例 匹配项示例 ...
