Contributions
Re: Host swagger API documentation on my own server
[Edited. Originally required hosted JSON spec. Now uses simpler local file approach.] So, I found that the docker approach was the easiest way to go. From what I've read, there are many different ways to get your API to show in a Swagger UI on your own server but I could never find one place with all the steps. I've pieced together ONE way to do it that worked for me. (I should note that I'm really only using Swagger for its documentation capabilities as I already have an API and a testing framework.) Here is a complete set of instructions: Edit your API in SwaggerHub. Make that your canonicalsource of truth. Export a JSON file of your API. This file should get checked in with your own server's code base. (Remember, I'm only using this for documentation -- I won't be generating any real APIs from this.) Let's call this file api.json. Keept it up to date as you would any documentation. Install docker. I got the docker community edition (https://www.docker.com/get-docker). It's free. The process will require you to register. You will need to run this in your server environment. Install the docker swagger-ui image using the following command: docker pull swaggerapi/swagger-ui Now you can run the Swagger UI with your specification using docker: docker run -p 80:8080 -e "SWAGGER_JSON=/api.json" -v /actual/path/to/api.json:/api.json swaggerapi/swagger-ui You should now be able to hit port 80 wherever docker is running and see your API spec. Note, for those of us unfamiliar with docker, the -v option can be confusing and the notes in github really threw me off. The path to api.json specified in the "SWAGGER_JSON=/api.json" assignment is not the actual path to api.json! The -v parameter will map the actual path to the path specified in SWAGGER_JSON. (Thanksponelat!!) --Ray34KViews2likes5CommentsRe: Host swagger API documentation on my own server
Thanks for making the point that the JSON is also accessible directly from a published instance directly on SwaggerHub. I should have added that I'm not ready to publish it and I'd like to restrict who has access to the API docs by IP address. By self-hosting the JSON, I have much more control over that. --Ray34KViews0likes3CommentsRe: Host swagger API documentation on my own server
Hi, I'm building my API in swaggerhub and I exported a JSON file. I'd like to host that on my server. I cloned the github swagger-ui project (https://github.com/swagger-api/swagger-ui) though I'm not sure why I need to do this if I'm just using the pre-built docker image. While not explicitly mentioned in your documentation, it's clear that you require docker to be installed. I installed docker and created an account on docker hub. This is not a small step and seems to render the cloning step as unnecessary, no? I then ran the commands specified in the swagger-ui github project: docker pull swaggerapi/swagger-ui docker run -p 80:8080 swaggerapi/swagger-ui I was successfully able to see the petstore example on localhost. (yay) Then I ran the command that was supposed to let me see my own API configuration in the UI (minus the -v run option): docker run -p 80:8080 -e "SWAGGER_JSON=/path/to/my/swagger.json" swaggerapi/swagger-ui I still only see the petstore example. (boo) What am I missing? --Ray34KViews0likes6Comments