asp.net core 3.0 中使用 swagger

asp.net core 3.0 中使用 swagger

Intro

上次更新了 asp.net core 3.0 简单的记录了一下 swagger 的使用,那个项目的 api 比较简单,都是匿名接口不涉及到认证以及 api 版本控制,最近把另外一个 api 项目升级到了 3.0,还是遇到了一些问题,这里单独写一篇文章介绍,避免踩坑。

Swagger 基本使用

swagger 服务注册:

中间件配置:

为 Swagger 添加 Bearer Token 认证

支持多个 ApiVersion

自定义 Api version 相关的 OperationFilter:

中间件配置:

最终 swagger 效果

Memo

上面的配置来自 https://github.com/WeihanLi/SparkTodo 这个项目,要获取代码可以参考这个项目

Reference

  • https://github.com/domaindrivendev/Swashbuckle.AspNetCore/tree/master/test/WebSites/MultipleVersions/Swagger

  • https://stackoverflow.com/questions/58197244/swaggerui-with-netcore-3-0-bearer-token-authorization

  • https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/1295

  • https://github.com/WeihanLi/SparkTodo

我来评几句
登录后评论

已发表评论数()

相关站点

+订阅
热门文章