我正在记录一个api，但在swagger web中加载时会添加一些代码。我正在Eclipse中编写带有swagger的propper注释的api，例如：@Min(17)@NotNull但在eclip
浏览 58提问于2020-05-13得票数 0
回答已采纳
我正在尝试从springfox-swagger2 (OpenAPI 2)迁移到springdoc-openapi-ui (OpenAPI 3)，以生成更好的文档。下面是一个示例路线：public interface IObjectController {
@RequestMapping(生成在springfox-swagger2中运行得很好，但是我发现了springdoc的以下问题
浏览 1提问于2020-04-30得票数 3
回答已采纳
我创建了一个Spring应用程序，它使用RestController验证传递给POST方法的DTO，该方法基于JSR 303验证注释。API文档是使用Springfox生成的。验证是正确应用的，并显示在OAS2 API文档中。然而，它们在OAS3 API文档中是不完整的--不为Integer字段生成最小/最大边界。由于我在文档+ Springfox问题跟踪和JSR303支持中没有发现具体的
浏览 6提问于2022-01-14得票数 0
回答已采纳
1回答
我试图使用Swagger来记录一个基于Spring的REST-API，并且在获得Swagger以反映自定义序列化程序和反序列化器的使用时遇到了问题。当我在Spring控制器中启用带有注释的Swagger时，生成的文档将忽略自定义序列化程序，并将模型描述为已使用默认Jackson设置进行序列化。然而，我所期望的(在Swagger文档中找不到这方面的任何内容)是一种在模型类的相关属性上使用Swagger
浏览 4提问于2015-02-23得票数 1
1回答
我的任务是为使用jaxrs开发的大型API找到最好的方法，以便为第三方编写文档。该代码目前已经用javadoc编写了详细的文档。The Swagger JAXRS doclet:
此maven插件在构建时工作，能够根据现有的javadoc注释为我们提供合理的文档。，它可能限制在响应中描述标题，这对我们的使用至关重要。它能够获得rest服务，而不需要swagger插件所需的@Api或@ApiOperationAn注释
浏览 2提问于2016-05-23得票数 2
回答已采纳
1回答
我有一个返回对象的Web API REST web服务。我已经安装了以及Swagger UI。我希望Swagger UI列出从Web API REST方法返回的对象中的字段。这个是可能的吗？在Swagger文档中，Swagger.NET使用ApiExplorer收集有关我拥有的Web API端点(扩展ApiController的类)的信息。此外，Swagger.NET查看.NET文档</em
浏览 9提问于2013-04-24得票数 2
2回答
我想自动生成API调用的描述，包括：
2.)对端点/页的描述我花了相当长的时间搜索各种查询，似乎找不到答案。
编辑:在我的例子中，在ASP.Net帮助页面上使用Swagger有什么好处？
浏览 5提问于2015-06-12得票数 13
回答已采纳
/items not found",}@Api(value = "/items", listingPath = "/api-docs.items", description = "Operations about Items")以下是控制器方法的注释=&q
浏览 2提问于2013-07-08得票数 2
我正在使用Spring MVC (通过Spring Boot)，并使用swagger-spring-mvc库集成了Swagger API文档。Money getListPrice() { }}{}
浏览 6提问于2015-03-31得票数 17
回答已采纳
我正在为用node.js编写的API创建文档。
我手工创建了一个swagger.json文件，并将其输入到swagger-ui前端，以便生成漂亮的API文档。但是，我想要做的是以类似于JSDoc的方式从代码中生成API文档--只需用注释标记代码，然后运行一个命令，直接从代码创建文档(在本例中是swagger.json文件)。
浏览 1提问于2022-11-09得票数 0
回答已采纳
6回答
如何生成离线Swagger文档？
、、、、
我已经能够集成Springfox的API文档。当服务器启动和运行时，我可以直观地看到所有的API。
如何生成离线的swagger文档？注意:我不想使用asciidoc或标记文档，但我想在html文件中使用相同的swagger用户界面。我希望链接是相对于本地目录而不是本地主机服务器链接。谢谢
浏览 10提问于2016-01-25得票数 17
回答已采纳
我们使用WSO2 API管理器1.10.0进行API管理。我以前已经设置了一个API，它是通过作用域到角色映射来限制的。现在我们必须处理这个API的多个版本(不是所有客户端都可以同时迁移到新版本)，但是我似乎不能重用我限制了以前版本的相同范围(范围键和作用域名称)？
这看起来很奇怪吗？这是否意味着我需要为每个版本的API创建唯一的作用域到角色映射？这意味着使用/default api的订阅者在请求访问令牌时必须更新其作用域名称，这取决于他们使用的是哪个版本的API</e
浏览 4提问于2017-11-17得票数 1
回答已采纳
很难配置Swagger，以下是非常有解释性的文档：
不推荐YAML文档字符串。有人知道如何从python代码中配置Swagger吗？或者，我应该将哪个文件更改为组api端点、向每个端点添加注释、在Swagger中添加查询参数字段？
浏览 6提问于2016-07-23得票数 19
回答已采纳
swagger版本1.5.20 private ZonedDateTimeDto publishDate;
@ApiModelProperty(value="This DOES display in swagger ui docs&qu
浏览 2提问于2019-01-09得票数 4
我正在试着用Slim写一个小的Api。我想要很好地记录它，所以我安装了swagger-php和UI，并在最后几天对其进行了研究。由于某种原因，我的petstore演示遗漏了所有的post注释。在此示例中，我的API将如下所示：
举个例子就太好了。谢谢
浏览 0提问于2014-05-03得票数 1
我正在使用Swagger来记录我的project.And，我想从springdoc生成YAML文档。但是当我生成这个YAML文档时，YAML没有我的Swagger文档注释。例如。当我生成YAML文档时，我看不到我的注释(比如："Return a list of Pix Wallets“)。在我的YAML文档里。例如： paths:
/api/pix/digital-wal
浏览 54提问于2020-10-24得票数 0
2回答
我是Swagger的新手，我有以下疑问：存在一种自动完成的方法吗？从我的Java代码到Swagger yaml文件？例如，以某种可以被某些工具解析的方式记录我的Java代码？
浏览 12提问于2017-01-13得票数 2
1回答
文档框架: java
、、、
我在java中有一个项目，在REST中有API。我想在API上创建一个带有文档(标记)的wiki。首先只进行规范，然后还包括测试API (API控制台/资源管理器)的方法。这些是带有OpenID (OAUTH)身份验证和令牌的API。谢谢。
浏览 0提问于2018-05-28得票数 1
我正在尝试弄清楚如何自定义swagger页面。目前它使用swagger-ui自动填充新的API，这很棒，但我需要向这些API添加更多的自定义信息，这就是我的问题所在。 但我搞不懂什么是大摇大摆。它看起来像是有一个名为swagger-ui-dist的节点包，我还看到了一个src/main/webapp文件夹和一个swagger-ui文件夹，其中包含一个index.html页面。我想我最想要的是用swagger来代替当前的swagger
浏览 26提问于2020-07-15得票数 0
我们使用Swagger来记录我们的REST API。我们在Spring REST控制器中使用各种swagger注释import io.swagger.annotations.ApiOperation@RequestMapping("/api/blah")public class
浏览 0提问于2018-05-30得票数 1
云服务器
ICP备案
云直播
即时通信 IM
实时音视频
腾讯云开发者
