Hi @Anil Sagar,
I wanted to know if developer portal uses swagger ui module to render API Specs on the portal pages. And if the spec has to use some external file references then how does developer portal resolves those references - locally or online? I mean if I need to create some reusable definitions that will be used across multiple specs then how to I host those specs - on a local directory on the same server where the portal is installed or on a repository on the internet?
Remote references are useful for authoring, but a consumer who wants to understand how an API works needs a fully resolved spec. Resolving that can run into problems, such as circular references or even worse, references that are hidden behind auth. This is why we expect a fully resolved spec, and that any real-time rendering would be as performant as possible. We don't have plans to resolve those any time soon.
If you need a resolver to build into your toolchain, we recommend Sway. If you must resolve specs at the time of rendering, you may want to look into the Swagger UI Field Formatter module to see if it will help you.