Is it possible to create an HTML link to a specific API within a JSON Swagger file?

I have swagger files with URLs like https://gitlab.com//blah/blah/Orders_Swagger.json. I'm building some documentation that links to these files; that works fine. Gitlab renders the page with nice formatting. But some swagger files have dozens of APIs and sometimes I want to reference a specific, critical API, not just send the user to the top of the page.

Solution 1:

Swagger UI supports a "deepLinking=true" configuration parameter. It is set to false by support. Gitlab embeds Swagger UI, but does not provide a way to set this parameter, so it is off at the server level.

However, you can enable it by passing a parameter in the URL: &deepLinking=1

Thus, a full, API-specific URL will look like this: https://gitlab.com/company/blah/blah/Swagger.json?deepLinking=1#/section/targetApiName