openapi相关内容
有没有办法从Swagger/OpenAPI规范生成控制器Spring MVC代码? 我知道Swagger可以从现有的Spring代码生成,但反过来有可能吗? 推荐答案 可以从命令行使用swagger codegen或使用swagger editor。
..
我尝试从OpenAPI v3 YAML文件生成Spring REST接口。 内部版本显示: Successfully generated code to property(class java.lang.String, property(class java.lang.String, fixed(class java.lang.String, /home/zolv/workspaces/ma
..
我想知道Swagger中是否有授权请求包含外部文档的URL的选项。 我有以下配置,我感兴趣的是urls[1]部分 springdoc.swagger-ui.urls[0].url=/v3/api-docs springdoc.swagger-ui.urls[0].name=default springdoc.swagger-ui.urls[1].url=https://asdasd.b
..
我已经创建了一个REST风格的API,现在我正在定义Open API 3.0 JSON表示以使用此API。 当存在另一个参数时,我要求有条件地使用参数。所以我不能真正使用required: true或required: false,因为它需要是有条件的。我是否应该将其定义为required: false,然后在summary和/或description中说明在使用其他参数时它是必需的?或者有
..
我正在使用Swagger/OpenApi V3批注创建应用程序的API描述,这些批注是从以下依赖项导入的: org.springdoc springdoc-openapi-ui 1.1.45
..
我有一个开放的API规范,其参数如下所示:@ - name: platform in: query description: "Platform of the application" required: true schema: type: string enum: - "desktop" - "online" 当我从URL中获取
..
我正在使用swagger Openapi规范3.0从我的界面生成swagger。我有一个Delete方法,它接受请求正文。但根据RFC7231,Delete不接受任何请求Body。Swagger-request body也是如此。但是我的API被设计成在删除操作中接受请求正文。在创建swagger以使删除操作接受请求正文时有什么解决方法吗?目前,我从Savagger生成中得到的错误是什么?
..
我的应用程序正在启动MVC,而不是启动。 我使用的是springdoc-openapi-ui 1.4.4 另外,我将以下导入添加到我的一个@Configuration类中; org.springdoc.core.SpringDocConfigProperties.class, org.springdoc.core.SpringDocConfiguration.class,
..
我正在尝试为从OpenAPI 3 YAML生成的Spring REST应用程序生成API文档终结点(例如/v3/api-docs)。 我注意到Maven plugin有一个generateApiDocumentation标志 我不太确定它是做什么的。 遗憾的是,SpringFox还不支持OpenAPI 3--而且,当我只想将初始的YAML公开为json时,使用基于反射的生成器似乎毫无意义。
..
我已经设法从.yaml开放API描述符文件生成了接口,但是,正如问题标题中所述,我希望将这些接口的响应类型从ResponseEntity更改为我自己的类型。基本上不是具有以下签名的接口: ResponseEntity clearCache(); 对于基本上是这样实现的方法: public void clearCache(){ //do something} 我希望
..
在Swashbakle 5之前,可以定义和注册可以提供模型实现示例的ISchemaFilter: public class MyModelExampleSchemaFilter : ISchemaFilter { public void Apply(Schema schema, SchemaFilterContext context) { if (contex
..
对于我为成功进行身份验证而记录的旧版API,我需要提供以下标头: X-Access-Token: {token} Accept: application/json; version=public/v2 对于我需要的令牌部分,通过以下方式记录: openapi: 3.0.0 info: version: "v2" title: Company App Public Api
..
我试着遵循这些: https://www.dariawan.com/tutorials/spring/documenting-spring-boot-rest-api-springdoc-openapi-3/ 如何处理如下批注: @ApiModel(value = "Response container") @ApiModelProperty(value = "Iventory
..
我正在构建一个简单的OpenAPI 3 YAML规范,如下所示: paths: /query: get: parameters: - $ref: '#/components/parameters/bookid' components: parameters: bookid: in: query name: book
..
我正在使用Openapi 3.0.0。一切都运行得很好。例.正在生成cURL、显示的响应正文、响应标头。 但在服务器响应下未显示“请求持续时间” 参考附件 推荐答案 您必须在swaggerOptions中添加displayRequestDuration: true, displayRequestDuration:默认情况下boolean=False。控制“试用”请求的
..
我正在尝试使用OpenAPI 3从各种架构组件构建响应。响应基本上分为三个部分: 其他终结点使用的共享组件(即成功/失败标志)。-#/components/schemas/core_response_schema内部allOf。 此终结点上的所有响应使用的属性(即user_id)-以下的properties组件。 根据用户类型的不同而不同的几个架构之一。-oneOf组件。 我已经确
..
我遵循了本教程Swagger UI on MicroProfile OpenAPI,但简单地将以下代码添加到Payara微应用程序的pom.xml文件中并不能添加/openapi-ui,而只能添加/openapi。是否还需要其他内容,或者Payara Micro是否不可能拥有OpenApi用户界面。 org.microprofile-ext
..
我正在使用Spring Boot,并且我希望使用Swagger UI使用json发送多部分文件,但如果我使用Postman工作得很好,则收到错误'application/octet-stream' error not supported。 @RequestMapping(value = "/upload", method = RequestMethod.POST, produces = {
..
我正在尝试为现有终结点编写OpenAPI3规范。终结点使用Content-Typeofmultipart/form-data,其中一个参数接受JSON数组字符串。下面的卷曲显示了此终结点正常工作的示例: curl -X 'POST' 'https://testing.org/test/' -H 'accept: */*' -H 'Content-Type: multipar
..
我正在尝试为此multipart/form-data请求创建OpenAPI定义: curl -X POST http://localhost:1234/api/v1/Submit -H 'cache-control: no-cache' -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundar
..