Skip to content

swagger page issues after springdoc-openapi for swaggers APIs updates

We are seeing few issues after after springdoc-openapi for swaggers APIs updates were pushed as part of ADR #97 (closed)

  • Swagger page on Core services is unreachable. Swagger page can be browsed when service is running locally but it does not work when it's deployed on CSP platform. We have at least observed the issue on the Azure, but similar issue may exist for other CSPs.

    Most of the services are responding with no error but nothing get displayed on the page. On debugging the issue it seems some related URLs are not accessible due to authorization policy. Here is the screenshot:

    image

    In one instance for register service, we are getting 403 error.

  • Each API on all services has incorrect header: frame-of-reference added to their spec. This header is only applicable for Storage service's record:batch API only. In some instances, this header may even show up multiple times. Here is one example:

    image

Edited by Neelesh Thakur
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information