Forum Discussion

thor's avatar
thor
New Contributor
4 years ago
Solved

Url parameters in path and query

Hi there, our api allows path parameters only. Like so : ourdomain.com/api/v1/param1/param2/param3/param4/ "param4" is subdivided in parameters. They serve more or less as filters. Sub paramet...
  • HKosova's avatar
    HKosova
    4 years ago

    Hi Thor,

     

    what has to be done in order to create a client / html-site, the looks the same way like the editor version ?

    The right-side panel of Swagger Editor is Swagger UI. To host Swagger UI on your server, use its dist assets and change the url parameter in index.html to point to your YAML/JSON file.

thor's avatar
thor
New Contributor

Hi Helena,

 

again ... that worked very well.

Thanks a lot!

 

non-the-less I have another question with regard to the layout.... would be grateful if you can get me started one more time.

 

Before I just created an html2-client. It looked a bit different to the right (display-) side of the swagger editor but it had a vertical menu on the left side.

 

Now I followed your instruction a delivered 100 % of what I had asked for, but is there a way to a navigation bar ? Can you tell how to get that ?

 

Best Thanks!

 

Thor

 

 

 

 

 

 

HKosova's avatar
HKosova
SmartBear Alumni (Retired)
4 years ago
is there a way to a navigation bar ?

Swagger UI does not have a built-in navigation bar, this is something you'll need to add yourself. Here's an example of how someone else did it:

https://api.biostar2.com/v2/docs/

 

Basically, instead of using Swagger UI's index.html page you can create your own web page with a navigation bar and embed the Swagger UI component into the page. Swagger UI generates anchors (aka deep links) for individual tags and operations:

PAGE_URL#/tagName/operationId

You can include these links in your navigation bar to scroll to specific tags and operations.