swagger-core
swagger-core copied to clipboard
Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API
Removes properties annotated with `@JsonBackReference` from the model, as Jackson automatically populates this with the parent. Without this, you must annotation the model with `@Schema(hidden = true)` fixes #3682 and...
Fixes #4657 Extra: fixed yaml checks - yaml by default always uses \n separator
I'm trying to document the following class, which is returned by a Spring-based API: ```java public class CytoscapeJsWrapper { ... @Schema ( description = """ As per Cytoscape.js, this contains...
Hi, I have an object like ``` public record Car(String model, @JsonUnwrapped @Schema(implementation=ResourcePath.class) Resource resource, boolean selected) { } public abstract class Resource { } public abstract class ResourcePath extend...
Like to propose a new property to set Future ,UpComing ,InNextRelease something to represent API specification to showcase user what they can expect in next release . just to opposite...
## Issue description When generating schemas based on constructor parameters of jax-rs resources (which would be operation parameters in open api specs), the `ReaderUtils#collectConstructorParameters` method is used. This method then...
I'm trying to do something like this: ```java @GET @Path("/foo") @Operation(responses = { @ApiResponse(responseCode = "204") }) public Response foo() { return Response.noContent().build(); } ``` which should have the following...
I was trying to convert json string to OpenAPI object and met below error: > Cannot deserialize value of type `io.swagger.v3.oas.models.parameters.Parameter$StyleEnum` from String "form": not one of the values accepted...
Using builder setter and setting JsonProperty Access will not get property types correctly. ```java public class ResourceSearchVO implements Serializable { private String name; @JsonProperty(access = JsonProperty.Access.WRITE_ONLY) private ResourceEnum type; public...
The default behavior for JsonParser.Feature.INCLUDE_SOURCE_IN_LOCATION was changed from `true` to `false` in Jackson 2.16: https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.16#streaming-jackson-core As swagger / OAI specs pretty much by definition are open and thus should never...