swagger相关内容
我目前正在将我们的 API 文档(即 Swagger 1.5)迁移到 Swagger 2.0 (OpenApi 3.0) API 文档是使用 maven 包 swagger-annotations 和 swagger-jaxrs 生成的 Swagger 文档.我已经用新版本更新了 pom.xml,所以它看起来像: io.swagger.core.v3
..
如何配置 swashbuckle 以使用 Aspnet API 验证?https://github.com/Microsoft/aspnet-api-versioning 在我的 Startup.cs 中,我有以下代码来初始化基于属性的路由、api 版本控制和 swagger. var constraintResolver = new DefaultInlineConstraintReso
..
我有 .Net 3.1 Web Api,我想删除这部分“架构";在 Swagger 用户界面上. 怎么做? 解决方案 不需要模式过滤器.经过几天的努力,我发现: 所有需要做的都在 app.UseSwaggerUI(options =>{options.DefaultModelsExpandDepth(-1);}); 注意:它是 DefaultModels(复数)而不是 Defa
..
我需要描述一个 api,它在请求正文中有一个带有必填字段的对象,其中一个字段是一个对象本身,它具有另一组必填字段. 我正在使用 open api v3 和 swagger 编辑器 (https://editor.swagger.io/)在我将 .yaml 文件放到编辑器上后,我生成了一个 html 客户端(> 生成客户端 > html).然后我打开在获取此架构的 .zip 文件中生成的静态页
..
我们正在开发一个带有 JWT Bearer 身份验证的 .Net Core 2.1 Web API.应用程序本身将生成并分发要发送到后端的令牌. 虽然我们已经启动并运行了所有内容,即我们可以从 Angular 发送不记名令牌并使用 Postman 进行测试,但 Swagger 不会发送不记名令牌.我们添加了 Swagger 配置以使用 SecurityDefinition,如下所示,我将发布
..
我已经学习了一些教程,并且已经让它在工作中工作,但由于某种原因,我无法让 UI 显示,但创建了 Swagger Json.我看的最后一个教程是 这里. 我的设置是这样的: Nuget 包: Swashbuckle.AspNetCore(1.0.0) ConfigureServices 方法: services.AddSwaggerGen(options =>{options.S
..
这个问题被问了很多不同的语言.经过大量(无果)浏览后,我感觉很愚蠢,但无论如何我都会问 本文档指的是在看似 Javascript 的内容中添加 Swagger 插件https://github.com/swagger-api/swagger-ui/issues/3725 我尝试将该代码添加为注入的 Javascript 资源: c.InjectJavaScript(thisAssem
..
根据文档(http://swagger.io/open-source-integrations/)有 Java 到 Export Swagger 文档到 PDF 的插件,我只是看看文档,但我看不到任何关于 .NET 的内容. 我的问题是:是否有类似于 .NET 中的 Java 插件 swagger2markup, swagger2markup-gradle-plugin 或其他从 WEB A
..
..
我正在使用 Swagger 和 Scala 来记录我的 REST API.我想为 POST、PUT 和 DELETE 启用批量操作,并希望相同的路由接受单个对象或对象集合作为正文内容. 有没有办法告诉 Swagger 参数是 A 类型值的列表或 A 类型的单个值? 类似于 REST 的可变参数. 解决方案 有没有办法告诉 Swagger 参数是 A 类型值的列表或 A 类型
..
我尝试更改我的 json 文件中的 basePath,这似乎只更改了 swagger-UI 的底部“baseurl".我想摆脱作为我的 swagger-UI 的组标题出现的“默认".有没有人能够解决这个问题?我正在使用 Swagger ~2.0. 解决方案 Default 不是路径,而是标签. 在 Swagger 2.0 中,分组是使用标签完成的.每个操作都可以分配给零个或多个标签.
..
我正在使用 Swagger Codegen 启动 REST 服务.我需要对不同的参数有不同的响应. 示例:/path 可以使用 ?filter1= 或 ?filter2=,这些参数应该产生不同的响应消息. 我希望我的 OpenAPI YAML 文件分别记录这两个查询参数.这可能吗? 解决方案 2.0规范不支持,3.0也不支持. 以下是 OpenAPI 规
..
..
我正在使用带有 ASP.NET Core Web API 的 Swashbuckle 6 (Swagger).我的模型以 DTO 作为后缀,例如, 公共类 TestDTO {公共 int 代码 { 获取;放;}公共字符串消息 { 获取;放;}} 如何在生成的文档中将其重命名为“Test"?我尝试添加一个带有名称的 DataContract 属性,但这没有帮助. [HttpGet]公共 IAc
..
我有一个spring boot项目想通过springbox与swagger集成. 我的 Spring Boot 应用程序启动并运行良好. 但是我添加了springbox后,它无法通过单元测试. 这是我在项目中添加的详细信息. 对于pom.xml,添加 io.swagger
..
在 OpenAPI (Swagger) 2.0 中,我们可以像这样定义标头参数: 路径:/邮政:邮政:参数:- 在:标题名称:X-用户名 但在 OpenAPI 3.0.0 中,参数被请求体替换,我找不到定义标头参数的方法,这些参数将进一步用于身份验证. 在 OpenAPI 3.0.0 中定义请求标头的正确方法是什么? 解决方案 在 OpenAPI 3.0 中,header 参数的
..
我创建了一个带有 ImageField 的简单模型,我想使用 django-rest-framework + django-rest-swagger 创建一个 api 视图,该视图已记录并能够上传文件. 这是我得到的: models.py 从 django.utils 导入时区从 django.db 导入模型类 MyModel(models.Model):source = model
..
如何使用 Swagger 2.0 注释定义基本身份验证并将其显示在 Swagger UI 中. 在我拥有的资源中: @ApiOperation(value = "返回类别列表", response=Category.class, responseContainer="List", httpMethod="GET", authorizations = {@Authorization(valu
..
应用程序几天前正在使用 Springfox Swagger 3.0.突然停止工作.一周前创建的 Jar 文件仍在工作,但现在当我们尝试构建一个新的 Jar 文件时,即使没有任何代码/库更改,它也无法正常工作.我什至参考了以下网址,但仍然面临问题. 404 错误与 swagger-ui 和 spring webflux 下面给出我的配置: POM 文件:
..
给定一个现有的带有 JAX-RS 注释的 API,它接受 &返回带有杰克逊注释类型的json,有没有办法可以生成一些YAML Swagger文档?我的计划 B 是编写一些代码,使用反射来查找带有 REST 注释的类型,制作它们的参数的哈希图 &返回,然后为 Jackson 注释爬取这些类,并以这种方式生成文档. 我更愿意使用已经存在的解决方案来编写一次性的东西.我发现这个 Swagger
..