External API SWAGGER

to access Swagger for SDC external API's

1. in the browser go to http://<ip of the SDC Backend server>:8080/
2. in the window that opens, Replace the address with http://<ip of the SDC Backend server>:8080/sdc/swagger.json and click "Explore".
3. you will be prompted for a username and password since the APIs have basic authentication on them.
4. use the consumer user and password you defined.
5. if you want to define such credentials follow this link: Consumer creation
6. you will be directed to the following screen:

Swagger conversion to HTML

to convert swagger to HTML you need to convert it first to markup

to do this download https://github.com/Swagger2Markup/swagger2markup

and then run:

java -jar swagger2markup-cli-<version>.jar convert -i <swagger.json> --outputFile <swagger.adoc>

now download asciidoctor https://asciidoctor.org/

based on the out put you will need to run:

asciidoctor <markup file location *.adoc> -b html5 -a toc=left,toclevels=4,doctype=book,numbered,sectanchors,hardbreak

Swagger conversion to PDF

now download asciidoctor https://asciidoctor.org/docs/asciidoctor-pdf/

asciidoctor-pdf <markup file location *.adoc> -b pdf -a toc=left,toclevels=4,doctype=book,numbered,sectanchors,hardbreak