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
  Hey! I have a question and hope someone can help! When I user more than one @Schema with same "ref" field ,how can I show the description. Thanks...
OAS 3.1 was released, can we support OpenAPI Spec 3.1? OSA 3,1 has some new feature, such as [namedEnum](https://github.com/OAI/OpenAPI-Specification/issues/681) and so on.
Please reopen https://github.com/swagger-api/swagger-core/issues/1855. The bug is still present. None of the all possible combinations I could think about gives the expected result, and most of them even do not produce...
In my company when we create code in Java we always use a fluent api, mostly using Project Lombok. ``` @lombok.Data @lombok.experimental.Accessors(fluent=true) public class Person{ private String name; } ```...
I am developing a simple application where I would like to read the files from a remote URL and add them to the `@ExampleObject`. I am able to achieve this...
[Open Api Specification 3.1.0 ](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#referenceObject) allows description and summary properties for referenceObject, so schema like in example is valid: ``` Home: type: object properties: home_address: description: "its the home address"...
The strings `"yes"` and `"no"` are serialized wrongly to YAML, when for instance used in enums. Seems the underlying jackson library works well until configured to serve OpenAPI purposes. ```kotlin...
This fixes issue 3998. If there exist jackson fields, or private methods, then jackson will serialize these as the values for an enum. This enables looking for those values first...
| Q | A | --------------------------------- | ------- | Bug or feature request? | Feature request | Which Swagger-Core version? | 2.0.0 | Which Java version? | 1.8 | Which...
I think it will generally a good idea to make `@ApiResponse` annotation as repeatable. We are using swagger a lot and each time wrapping it within `@ApiResponses` is not very...