object query

从零开始搭建前后端分离的NetCore2.2(EF Core CodeFirst+Autofac)+Vue的项目框架之十二Swagger(参数)使用二

我与影子孤独终老i 提交于 2020-08-15 07:27:10
   引言   在 上一篇 中提到了 Swagger 的基本使用,仅限于没有参数,没有验证的那种api文档生成,那么这篇就连接上篇继续,在一般具有安全性、权限等验证的接口上,   都会在header/url中加上请求者的秘钥、签名等,当然也有可能添加到body等其它地方, Swashbuckle.AspNetCore 都支持这些写法。    如何使用 -- 下面将介绍两种使用方式 两种方式参数设置到何处都是在 In 属性 上,属性对于值如下: 参考 https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#parameter-object query: 参数字段值对应放在url中 header: 参数值对应放在header param中 body: 参数对应放到请求体中 path: 参数应该对应放到请求路径 // 具体貌似没用 formData: 参数对应放到请求表单中    第一种:将一个或多个参数保护API的“securityDefinitions”添加到生成的Swagger中。 这种是直接在文档的右上方添加一个 Authorize 按钮,设置了值后,每一个请求都会在设置的位置上加上相应的值,在 上一篇随笔中的 ConfigureServices 方法中, 对应位置 services