Generate Swagger using springdoc-openapi OAS 3.0
Link to ADR(Architecture Decision Record) : Swagger using springdoc-openapi
OpenAPI 3.0 related changes
-
upgraded to latest springdoc openapi latest version 1.7.0
-
Documented LegalTagApi, LegalTagStatusJobApi, HealthCheckApi & Info API with OpenAPI 3.0 Annotations
-
Custom Path for
- Swagger UI: https://host/context-path/swagger (will redirect to https://host/context-path/swagger-ui/index.html)
- api-docs (JSON) : https://host/context-path/api-docs
- api-docs (YAML) : https://host/context-path/api-docs.yaml
-
Azure Swagger GLAB(for Reference)
- Swagger UI: https://osdu-glab.msft-osdu-test.org/api/eds/v1/swagger (will redirect to https://osdu-glab.msft-osdu-test.org/api/eds/v1/swagger-ui/index.html)
- api-docs (JSON) : https://osdu-glab.msft-osdu-test.org/api/eds/v1/api-docs
- api-docs (YAML) :https://osdu-glab.msft-osdu-test.org/api/eds/v1/api-docs.yaml
Other Changes
- Configurable descriptions managed in swagger.properties
- Updated Readme for swagger related information
- Deleted HomeController, SpringfoxSwaggerHostResolver and SwaggerDocumentationConfig
Edited by Jayesh Bagul