swagger

3热度

1回答

我正在使用Spring引导创建一个REST Api，并使用swagger codegen自动生成控制器中的swagger文档。但是，我无法为POST请求中的String类型参数设置说明和示例。下面是MI代码： import io.swagger.annotations.*; @Api(value = "transaction", tags = {"transaction"}) @Functi

1热度

1回答

Swagger - 声明异常的渲染响应状态

我正在使用Swagger来处理我的REST文档。我已经设置好了，并且可以在SwaggerUi上访问，并且还可以看到我配置的所有REST资源及其受支持的方法。在我的后端我有一个ControllerAdvice，它为我的所有控制器执行全局异常处理。当我尝试创建一个已经存在的资源时，在控制器建议中处理的示例异常是ResourceAlreadyExistsException。在这种情况下，我的异常处理程

0热度

1回答

参考swagger-UI的外部URL

我正在使用Spring启动项目，我们已经为它作为json文件提供了一个swagger文档。我们只包含了Swagger-ui，它在/projectName/swagger-ui.html下呈现。我们想利用引用我们的Swagger json的外部URL/projectName/docs/swagger。我们如何在Swagger-UI上实现这样的行为来使用我们自己的URL而不是/ v2/docs默认

0热度

1回答

验证RAML文件

假设我们有一些Swagger 2.0文档，例如 http://petstore.swagger.io/v2/swagger.json 我想将它转换为使用Apimatic的另一种格式。 https://apimatic.io/transformer 如果我将Petstore Swagger文档转换为WADL，结果似乎是无效的。我已验证WADL文件对 https://www.w3.org/Submi

0热度

1回答

查询参数依赖于hapi-swagger中的其他查询参数

我正在为我的api构建一个hapi-swagger接口。查询参数之一，类型，有另一个查询参数子类型取决于前者。我已经想出了如何实现Joivalidation for it successfully，但我并没有如此成功的接口。我的验证码是 { type: Joi.string() .valid('image', 'publication', 'dataset') .

1热度

1回答

未知的响应类型为204码状态

我需要来形容我的应用程序的途径，因此我用招摇： paths: /users: get: description: Returns all users responses: "204": description: No Content Found schema: $ref: "#/definitions

3热度

2回答

播放扬鞭UI网址别名

我Swagger UI的API文档，我用同样的方式就像在official specification访问它，我用下一个URL： http://localhost:9000/docs/swagger-ui/index.html?url=/assets/swagger.json 但我想用http://localhost:9000/docs/代替。我不会想用WS委派，我想用单一的线routes，像这

0热度

1回答

使用swagger和yaml生成java类

我想用maven插件swagger-codegen-maven-plugin版本2.2.3生成我的Java类。在这里我的pom.xml的配置文件： <plugin> <groupId>io.swagger</groupId> <artifactId>swagger-codegen-maven-plugin</artifactId> <version>2.2.3</ve

1热度

1回答

招摇：requestBody不允许

我试图定义使用招摇后端点，但不允许requestBody参数： /names/{roster}: get: #... post: x-swagger-router-controller: names description: Adds or removes name(s) operationId: manageNames

0热度

1回答

可选参数在Swashbuckle中导致null异常。Asp.Netpore

我有一个asp.net core 2.0 api控制器动作，带有一个可选（和可为空）参数。 Swashbuckle.AspNetCore 1.0.0当方法签名中存在此参数时，生成Swagger文档失败，但如果将其从签名中删除，则会成功。它出现的可选参数是错误的原因，但我不知道为什么...... 我使用与ASPNET-API的版本Swashbuckle整合： https://github.com/M