2回答
我的Swagger文档没有正确生成，我有基本信息(标题、名称、许可证等)，但我的路线上没有文档。{ app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger"info": { "description": "A &#x
浏览 4提问于2021-01-14得票数 1
回答已采纳
我在我的Spring Boot应用程序中使用Springfox Swagger2版本2.4.0、Springfox Swagger UI版本2.4.0和Swagger Annotation版本1.5.0这里的问题是，我能够为我的控制器的API生成swagger UI，并且能够对其进行测试。但我无法为我的请求标头指定请求标头描述。我使用@RequestHeader注解来做同样的事情。我的控制器API中的代码片段如下：
浏览 4提问于2017-02-20得票数 9
2回答
在Spring项目中，我使用了以下版本的springfox-swagger2 2库： <groupId>io.springfox</groupId</artifactId> </dependency>
我想使用下面的swagger文档为我的REST控制器
浏览 1提问于2018-05-30得票数 2
回答已采纳
1回答
我在我的应用程序中添加了一个新的模型"Book“，现在我想更新我的api-docs。我怎么能这么做？
我正在尝试rake swagger:docs，但这不会改变任何事情。另外，在books_controller direcotry中也没有其他控制器已经存在的app/controller/api/v1/。我是Rails和Swagger的新手，所以如果我缺少一些基本的东西，请忽略它。
浏览 12提问于2014-12-04得票数 1
回答已采纳
我试图用Springdoc替换手动维护的swagger文件。目前，我们使用来呈现文件，因为它们支持discriminator。
是否有一种简单的方法用ReDoc替换/取代嵌入的ReDoc？
浏览 22提问于2020-04-21得票数 2
回答已采纳
我正在使用Swagger，并尝试添加一个自定义路径变量。我的一个端点如下所示： http://localhost:8008/schools/{schoolId}/teachers/{teacherId} 我的控制器看起来像： {
@RestController可以为它添加一个占位符，但swagger的schoolId不是，所以当我处理任何端点时，我会得到： http://localhost:8008/scho
浏览 213提问于2020-11-09得票数 0
我正在尝试为Swagger中的控制器提供格式化的描述。但是，我找不到任何支持它的注释。目前它看起来是这样的：
然而，我想提供有意义的描述。不推荐使用带有@Api的description参数。
浏览 31提问于2021-03-10得票数 1
我知道我可以为swagger中的所有API添加header参数，如中所述
使用这种方法，header参数将显示在所有API的swagger UI中。但并不是我所有的API /控制器都需要header参数，有没有办法只为特定的控制器甚至特定的API添加header？
浏览 1提问于2017-06-05得票数 0
JSON在/v2/api-docs下可用，工作正常。我想要做的是为该端点启用CORS标头。我已经将以下方法添加到SwaggerConfig中，如中的全局CORS配置中所述。(与我自己的控制
浏览 5提问于2017-08-14得票数 16
回答已采纳
我理解在Spring中用Swagger编写API文档时，我可以通过添加@Api注释来更改API的描述，但是当我按如下方式添加它时只有描述被更改，而不是名称。如图所示此外，我不知道默认的名称和描述是从哪里来的，在添加API
浏览 0提问于2018-12-03得票数 4
回答已采纳
1回答
我想在swagger API描述符中添加一个自定义控制器。使用spring fox定制现有模型非常容易。但是我没有成功地从头开始将自定义API添加到swagger描述符中。举个例子胜过长篇大论。我做了一个测试项目springfox-test 我有一个控制器(ItemController)，它处理两个URL (/item/name和/item/number)并返回两个不同的bea
浏览 63提问于2019-01-21得票数 5
现在我需要使用生成API文档。有一个模块。我是否需要使用此模块重写整个应用程序，或者是否有任何其他解决方案来使用此模块，如果使用swagger-node，则swagger-ui的用途是什么。
浏览 2提问于2016-06-01得票数 0
首先，我想澄清一下，我使用swagger-codegen为基于Play Framework的服务自动生成代码。
目前，我在几个实现相同API但内部实现不同的项目中使用相同的swagger描述。我认为最好是根据在文件中定义的API创建一个包含所有自动生成代码(models和controllers)的独立JAR，然后将其添加到每个项目中，以减少重复，提高管理和节省编译时间。我怀疑是否可以将路由绑定到独立的JAR控制器。
浏览 0提问于2017-11-04得票数 0
回答已采纳
3回答
我正在使用Swagger-php和Swagger-UI，它们都工作得很好，但有一个麻烦。Swagger-UI为我的API路由创建的UI具有预期的单击展开部分，但每个部分的标题似乎是生成的JSON文件，而不是我可以给它命名的任何名称。在标题之后，描述是我在注释中给出的描述，但标题似乎无法控制。因此，如果我有以/foo的resourcePath开头的路由，并且描述为"Foo API函数“，则UI如下所
浏览 3提问于2014-03-06得票数 3
在我的NET6Web-API项目中，我使用OData和Swagger (在创建项目时它是自动添加的)。public class UsersController : ODataController // skipped for brevity
[EnableQuerySingleResult.Create(_dbContextRepo.Select<User>(
浏览 8提问于2021-12-21得票数 0
为了改进我们的api文档，我想向响应体的一个字段添加一个描述在宠物响应的POST /pet中，status的描述为“商店中的宠物状态”
我如何在我的代码库中从注释的角度来做这件事呢(swagger v3)
浏览 6提问于2021-01-20得票数 0
我已经看过这个Spring REST Docs - 我们喜欢Spring Rest文档可以用来生成REST API文档的功能，并且我们不需要在控制器代码中添加@ApiResponse或@ApiOperation这样的夸张注解。但是如果使用Spring Rest文档，我们将错过为我们的API自动生成的Swagger-UI (当我们使用
浏览 11提问于2017-03-15得票数 1
2回答
我在我的项目中包含了swagger-springmvc，并设法让Swagger UI正常工作，但现在关于UI中的API的信息很少。我看到的都是通过反射提取的信息。这是控制器方法的样子： * Read all users matching given filter return domain.getUsersFilt
浏览 12提问于2014-05-16得票数 2
我在spring mvc控制器中有方法.method参数，不需要设置@RequestParam就可以正常工作，.I想要在没有设置@RequestParam时使用swagger和spring fox forapi doc .but，它的参数swagger不工作.I在我的项目中有100个控制器，并且不能为控制器中的所有方法都设置这个注释。如何在不添加@RequestParam注释的情况下解决此问题？String searchFilter,
浏览 16提问于2016-07-10得票数 1
我们试图为我们的.NET Web生成Swagger1.2规范JSON。我尝试过使用Swashbuckle，但它似乎只生成Swagger2.0规范JSON。有谁知道如何从.NET Web生成Swagger1.2JSON(是否使用.NET)？
浏览 1提问于2015-02-18得票数 3
回答已采纳
云服务器
ICP备案
对象存储
云点播
云直播
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号