Questions tagged [springdoc-openapi-ui]
The springdoc-openapi-ui tag has no usage guidance.
368
questions
0
votes
0
answers
6
views
File Upload and Metadata using OpenAPI 3.0
I'm trying to migrate from spring boot 2 to spring boot 3 openApi following code(swagger 2) that uploads a file and a metadata string as parameters:
@ApiOperation(value = "Upload Document and ...
0
votes
0
answers
13
views
simple code using OpenAPI and spring. However, my swagger page keep saying "No operations defined in spec!"
I am pretty new with openApi generator. I generated a simple code using a yaml file. everything seems to run fine but when i am accessing the swagger page i am getting "No operations defined in ...
0
votes
0
answers
14
views
How to customize the order of groups in Open API definitions
I have a Jhipster generated reactive spring-boot application. By default jhipster generates 2 different groups in open api definitions: default and management. In the UI, default is the first option ...
0
votes
0
answers
13
views
Unable to Disable "petstore" URL in SpringDoc OpenAPI
I am currently working on a project using Spring Boot 3.1.2, SpringDoc OpenAPI Starter WebMvc UI 2.1.0, and JDK 17. I have encountered an issue where I am unable to disable the "petstore" ...
1
vote
1
answer
26
views
Modifying the' format' field in Springdoc OpenAPI Schema
I'm currently using Spring Boot 2.6.1 and Springdoc OpenAPI 1.7.0 in my project. In the generated OpenAPI documentation, I have a "Sortable" schema with a property "sort". The &...
0
votes
0
answers
53
views
SpringDoc OpenApi - use objectmapper dynamically
I have a Kotlin Springboot app that uses springdoc-openapi for generating Swagger documentation.
The app uses snake case as the default, but there is one endpoint where I had to use camel case. So I ...
1
vote
0
answers
32
views
JacksonAnnotationIntrospector is not working properly with Spring doc Schema
I have some API defined using Spring codegen, and the snippet for @ApiResponse is defined below:
@ApiResponse(responseCode = "201", description = "Created successfully", content = @...
0
votes
0
answers
45
views
openapi generator: Expected the field `xxx` to be an array in the JSON string but got `null`
I use spring-doc to generate yaml, then I want to use this yaml to generate java class by openapitools-generator, but there is an error: if there is a List with null, then error throw.
there are my ...
1
vote
0
answers
63
views
Springdocs-openapi-ui failed to load API definition
I have previously upgraded
spring boot from 2.6.x to 2.7.12
Springdoc-openapi-ui 1.6.5 to 1.7.0
Classgraph 4.8.139
Spring framework 5.3.27
Currently on Java 8
And a previous working condition of ...
2
votes
0
answers
62
views
How to apply mixins to the schema in Spring doc?
I have some API defined using Spring codegen, and the snippet for @ApiResponse is defined below:
@ApiResponse(responseCode = "201", description = "Created successfully", content = @...
0
votes
0
answers
18
views
Dynamic defaultValue for Pageable default-size in openapi for a spring boot 3 webflux controller
I am using a Pageable as a method parameter in a spring webflux controller.
I wanted to be able to override the default page size and the max size of the Pageable do a configurable property. I can do ...
0
votes
0
answers
10
views
OpenAPI v3 - how to clear input parameters on 'Try Out!'?
I have a Spring Boot application where we moved from OpenAPI declaration in a swagger.yaml file to annotations on methods like:
@Operation(summary = "Function to query something by some parameter&...
0
votes
1
answer
63
views
Open API Code first, Polymorphic Map Values
I want to generate Open API specs from Java code (code first). I am doing it by using following dependencies
<dependency>
<groupId>io.swagger.core.v3</groupId>
<artifactId&...
0
votes
1
answer
61
views
How to not expose entities endpoints in Spring Boot application
Upgrading my MS from Spring Boot 2.7 to 3.0, i've noticed that entities are exposed even i 'hide' and scan only controller package which contains only APIs,
for an entity Customer i could invoke all ...
0
votes
1
answer
67
views
White label error 404 SPRING BOOT open api ui
Good morning everyone,
I am struggling with Open APi docs
I have the dependency in my pom.xml file:
<!-- https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-ui -->
...
0
votes
0
answers
24
views
Springdoc Open API generation
My OenApiConfiguration looks like
@Bean
public OpenAPI customOpenAPI() {
return new OpenAPI().info(apiInfo()).components(new Components().addSecuritySchemes(OAUTH2, securityScheme()))
...
0
votes
0
answers
34
views
Openapi-ui swagger example generating as null
Migrating from Springfox to Openapi.
The Swagger document is generated, but the request and response example is showing as null. whereas schema definition shows proper.
Is there any internal ...
0
votes
0
answers
42
views
Swagger UI issue when having same root context for two different applications
Getting swagger UI issue when two different microservice having same application root context deployed on sandbox environment.
we are using ngnix as reverse proxy routing server between client and ...
0
votes
0
answers
17
views
Difference between my yaml file that i verify in swagger editor and swageer ui with spring doc
I have diff thing that is not shown in my swagger UI but it is written in my yaml file in the code.
I use spring doc for the génération of the UI.
for exemple i have multiple response http 200, 201 ...
1
vote
1
answer
61
views
Swagger UI gets stuck when trying do display an endpoint that has a proto POJO in its request body
We have a java 19, spring boot 3.0.5 based web application, that has an endpoint with a generated POJO object from a .proto as its @RequestBody. we are exposing the endpoint through swagger ui. ...
1
vote
1
answer
34
views
How to output almost two identical endpoints in Swagger UI
I have two identical @GetMapping, but different from each other by having one parameter. I presented them from below.
@GetMapping
public ResponseEntity<Response> getAll() {
List&...
2
votes
0
answers
189
views
springdoc-openapi-ui throws java.lang.ClassNotFoundException when swagger-parser is on the classpath
In a project which I currently try to upgrade to Spring Boot 3.x I'm using "springdoc-openapi-starter-webmvc-ui" and I also need "swagger-parser" for my business logic (I thought ...
0
votes
0
answers
90
views
[OpenApi v3]: Embedded @ArraySchema does not appear in example value
I have the following simple DTO:
public class AccountDto {
@Schema(example = "1", hidden = true)
private Long id;
@Schema(example = "100")
@NonNull private BigDecimal ...
1
vote
1
answer
74
views
Replace paramType in SpringFox
I have this @ApiImplicitParam annotation used by SpringFox to document endpoint. I want to migrate to springdoc.
@ApiImplicitParam(name = "Proxy", value = "Authorization value", ...
0
votes
0
answers
34
views
OpenAPI : change request body schema
I have a class
public abstract class Transfer<ID_TYPE> {
protected ID_TYPE id;
protected BigDecimal amount;
protected String text;
protected Debitor debit;
protected ...
0
votes
1
answer
37
views
Can Access Tokens be automatically sent from Open Api 3 for OAuth 2.0 authentication?
I have an Spring Boot 3 app. I use Keycloak and Open Api 3. Open Api (swagger) works fine for get methods, but not for post. For POST methods I get a 403. I see that I can configure OpenApi so that I ...
-1
votes
1
answer
183
views
How to make QueryDSL Springdoc predicates work in Springboot 3 as it did in Springboot 2?
I utilized Springdocs 1 in Springboot 2 to generate my Swagger documentation. In addition, I employed the springdoc-openapi-data-rest library to generate the additional parameters necessary for @...
0
votes
0
answers
67
views
TestRestTemplate can't reach /v3/api-docs endpoint during test
I have springboot 3 application with springdoc.
I making a junit test which try to validate the swagger schema using a TestRestTemplate.
I am making this request:
@Autowired protected TestRestTemplate ...
0
votes
0
answers
360
views
OpenApi 3 Swagger UI not working on Spring 2.7.12 with Spring Security Oauth 2
I have upgraded my spring version to 2.7.12 and migrating from springfox swagger 2 to springdoc openapi 3 (swagger 3). The swagger config api is working fine but due to webMVCConfig in my application ,...
0
votes
0
answers
129
views
Wrong response schema in OpenApi UI using SpringDoc with swagger yaml file
I'm having a issue where the response schema for the erros codes, such 400, 500 e etc. not being show as a no content in the swagger UI. It replicate the schema set for the 200 response code, when ...
0
votes
0
answers
2k
views
Springdoc openapi and Spring boot parent 2.7.10 compatibility
I upgraded my applications spring-boot-starter-parent version to 2.7.10.
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</...
0
votes
0
answers
74
views
Restricting auto generation of schemas definitions OpenAPI Spring Boot
When running the Spring Boot application with org.springdoc:springdoc-openapi-webflux-ui:1.7.0 when using nested complex types as properties, the generated schemas represent separate types as well as ...
0
votes
0
answers
150
views
Multiple swagger instances for a single application using springdoc
I want to have two swagger interfaces for the same springboot application like,
/api/auth/swagger-ui.html
/api/leagcy/swagger-ui.html
I am using this dependency
<dependency>
<...
0
votes
1
answer
368
views
OpenAPI with Spring Framework 6
I have a project which uses spring framework 6 (not spring boot). I just used @RestController, so I can return any type of Object. Now I want to document these rest apis. And for this, I tried to use ...
0
votes
0
answers
50
views
What is better approach to display in swagger-ui List parametrizied interface?
I use springdoc for describing API. I have the this request body
class SearchRequest {
val fields: List<Field>? = null
var searchTerm: String? = null
@Parameter(description = "...
0
votes
1
answer
610
views
openapi springboot - Error 'swaggerWelcome' threw exception
i use the dependency of org.springdoc, see below in y spring boot project
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-...
2
votes
3
answers
1k
views
NoClassDefFoundError with Open API with Spring Boot 3
I upgraded to Spring boot 3.0.7 and am trying to get my Open API (swagger) working again, with these dependencies (per springdoc):
<dependency>
<groupId>org.springdoc</groupId>
...
2
votes
1
answer
609
views
Swagger UI - Rendering nested object in multipart/form-data request "try it out" shows JSON instead of form UI fields
I am using Swagger/OpenAPI version: OpenAPI 3.0.3
Example Swagger/OpenAPI definition:
openapi: 3.0.3
info:
title: 'My API'
version: 3.0.0
servers: []
paths:
/api_app:
post:
...
1
vote
1
answer
436
views
Problem with org.springdoc swagger openapi 2 and springboot 3 when extend WebMvcConfigurationSupport for custom WebConfig
I'm trying to configure the org.sprindoc-openapi library in Spring Boot 3. In my application, I need to extend the WebMvcConfigurationSupport class for some custom configurations that I need to apply ...
0
votes
0
answers
282
views
Problem Displaying Swagger-UI After Spring Library Update
We have a webapp(war) that embeds the Swagger UI working under Spring Boot 2.7.5 and springdoc-openapi 1.6.14. I am in the process of updating Spring Boot to 2.7.11 and all is working fine. When I try ...
0
votes
1
answer
859
views
Spring OpenApi DTOs in GET requests
We use OpenAPI to generate the interface description for the services exposed in one of our server applications. We use that openapi.yaml then to generate client-sided libraries that will interact ...
0
votes
0
answers
34
views
Document childclasses with OpenAPI
I have a spring boot (2.7.11) application, where the entities are part of an inheritance tree:
@Getter @Setter @SuperBuilder
public class Foo {
private String foo;
}
@Getter @Setter @SuperBuilder
...
0
votes
0
answers
70
views
Open Api v3/api-docs not contains its all variables
i have a springboot project working with 2.5.14 version.
I migrate my Swagger 2 to Swagger Open Api but i got some errors.
While upgrading instead of using springfox, i removed them and started to use ...
0
votes
1
answer
852
views
Swagger V3 UI Not Sending In Authorization Header When 'Trying it Out"
I have a Spring Boot App (2.7.10) and am using the Sprspringdoc-openapi-ui dependency (1.6.15). I have annotated my controller and it seems to be displaying correctly, however when I try and execute ...
0
votes
0
answers
542
views
How to have examples in @Parameter in OpenAPI (Swagger) in Spring Boot?
I am wanting to essentially replicate a @RequestBody with @Parameter. I found this in Swagger documentation: "Also without a @RequestBody annotated parameter and with no @RequestBody annotation ...
0
votes
1
answer
177
views
SpringBoot OpenApi Doc OpenAPI, non-primitives objet are not nullable
i have a response model entity ResponseEntity:
RespDTO:
@Getter
@Setter
public class RespDTO implements Serializable{
/**
*
*/
private static final long serialVersionUID = 1L;
...
0
votes
0
answers
19
views
What use does Spring data jpa gives to classgraph dependency? Conflict between dependencies with Springdoc
I had a dependencies problem between Spring data jpa 2.7.2 and springdoc-openapi-ui 1.6.3, the conflicting dependency is:
<dependency>
<groupId>io.github.classgraph</groupId>
<...
0
votes
0
answers
229
views
How do I get the swagger-codegen-maven-plugin plugin to use the "errorOnUnknownEnum" property?
I'm using the following
<plugin>
<groupId>io.swagger.codegen.v3</groupId>
<artifactId>swagger-codegen-maven-plugin</artifactId>
...
0
votes
0
answers
229
views
Springdoc with multiple api-doc in diferent URL and PATH
I have an api in java 8 with springboot 2.7.5 and springdoc-openapi-ui 1.7.0 version.
I have three controller in this api like this:
/controllerOne
(group = ControllerOne)
/controllerTwo
(group = ...
0
votes
0
answers
279
views
Failed to get the response in Swagger 3 (open api) while using Java 19 and Spring Boot 3.0.x
I'm migrating from Spring Boot 2 to Spring Boot 3 with Java 19 and also using swagger 3 that's open api.
I have added the "open api webmvc ui" dependency in POM file and also changed Javax ...