I think enums can be defined only as object literals. Checkout this example it seems to explain quite well with an example. https://community.smartbear.com/t5/Swagger-Open-Source-Tools/Enum-of-defined-objects/m-p/198117/highlight/true#M988
responses: 200: description: Returns PDF schema: type: file Out of the options you gave, that’s the right option. Also, make sure to use produces: [application/pdf] If it fails for you, make sure you use the latest version of the editor. There was a bug related to the file type that was recently resolved.
This was caused by the line enableUrlTemplating(true) in Docket configuration which I copied from example and forgot to remove. After removing this line everything is working as expected.
TL;DR: $ref siblings are supported (to an extent) in OpenAPI 3.1. In previous OpenAPI versions, any keywords alongside $ref are ignored. OpenAPI 3.1 Your definition will work as expected when migrated to OpenAPI 3.1. This new version is fully compatible with JSON Schema 2020-12, which allows $ref siblings in schemas. openapi: 3.1.0 … components: schemas: … Read more
Maybe this can help: swagger: ‘2.0’ info: version: 1.0.0 title: Bearer auth example description: > An example for how to use Bearer Auth with OpenAPI / Swagger 2.0. host: basic-auth-server.herokuapp.com schemes: – http – https securityDefinitions: Bearer: type: apiKey name: Authorization in: header description: >- Enter the token with the `Bearer: ` prefix, e.g. “Bearer … Read more
@Bean public Docket newsApi(ServletContext servletContext) { return new Docket(DocumentationType.SWAGGER_2).pathProvider(new RelativePathProvider(servletContext) { @Override public String getApplicationBasePath() { return “/serviceName” + super.getApplicationBasePath(); } }).host(“proxyURL”); }
Original answer Support for Authorization: Bearer [JWT_TOKEN] header is working as of version 2.9.2 Added the following dependencies to build.gradle compile(“io.springfox:springfox-swagger2:2.9.2”) { exclude module: ‘mapstruct’ // necessary in my case to not end up with multiple mapstruct versions } compile “io.springfox:springfox-bean-validators:2.9.2” compile “io.springfox:springfox-swagger-ui:2.9.2” Configured Swagger via @Configuration @EnableSwagger2 @Import(springfox.bean.validators.configuration.BeanValidatorPluginsConfiguration.class) public class SwaggerConfiguration { public static … Read more
Your usage of additionalProperties is correct and your model is correct. additionalProperties In Swagger/OpenAPI, hashmap keys are assumed to be strings, so the key type is not defined explicitly. additionalProperties define the type of hashmap values. So, this schema type: object additionalProperties: type: string defines a string-to-string map such as: { “en”: “English text”, “de”: … Read more
Fixed!!! The issue exists as spring fox libraries internally depend on spring-plugin-core:1.2.0 but it actually requires spring-plugin-core:2.0.0. This dependency correction seems to be missing in the SNAPSHOT version of the swagger libraries for supporting web flux. We just need to correct Maven dependencies as given below and no code change is required: Maven POM Dependencies … Read more
You actually ask several questions in one, and I’ll try answering them all. In Swagger 1.2 and prior to it, the file splitting was mandatory and artificial. It was meant as a way to group operations, and Swagger 2.0 offers and alternative method to do that (more on it soon). Swagger 2.0 is indeed a … Read more