The api-docs.json generated by Swagger 3 contains all the endpoint paths which are annotated with @Operation in the RestController classes, but it doesnt include those endpoints which are also exposed by the API application but not part of the RestController for ex. /actuator/*, /v3/api-docs & /swagger-ui.html.
I import the generated api-docs.json into AWS API gateway to create Routes and Integration from CI/CD pipeline itself. This helps me create Route mapping in API gateway from CI/CD itself.
*The problem is that the generated api-docs.json file doesn’t include spring /actuator/ endpoints, swagger endpoints like – /v3/api-docs & /swagger-ui.html et**c, because of which these endpoints are not accessible through the R53 record which is pointing to API Gateway custom domain. I have to bypass API Gateway and use API gateway URL to access these endpoints.
I want to include these custom endpoints or a default catch-all endpoints in the api-docs.json itself so that I dont have to maintain two URLs and create a better experience of API consumers.