How to open local files in Swagger-UI

Question

I'm trying to open my self generated swagger specification file my.json with swagger-ui on my local computer.

So I downloaded the latest tag v2.1.8-M1 and extracted the zip. Then I went inside the sub folder dist and copied the file my.json into it. Now I opened the index.html and want to explore my.json. And here the problem begins:

If I enter a local path, it always will be prefixed by the current url containing the index.html. And therefor I can't open my file. I tried all following combinations without success:

• my.json leads to file:///D:/swagger-ui/dist/index.html/my.json
• file:///D:/swagger-ui/dist/my.json leads to file:///D:/swagger-ui/dist/index.html/file:///D:/swagger-ui/dist/my.json

Answer 1

I could not get Adam Taras's answer to work (i.e. using the relative path ../my.json).

Here was my solution (pretty quick and painless if you have node installed):

• With Node, globally install package http-server npm install -g http-server
• Change directories to where my.json is located, and run the command http-server --cors (CORS has to be enabled for this to work)
• Open swagger ui (i.e. dist/index.html)
• Type http://localhost:8080/my.json in input field and click "Explore"