Page Comparison

Swagger documentation

SDC Catalog External API

to access Swagger for SDC external API's

1. 1. in the browser go to http://<ip of the SDC Backend server>:8080/swagger-ui/index.html
   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:

...

1. 1. in the browser go to http://<ip of the SDC Backend server>:8080/sdc2

Swagger utilities

Swagger conversion to HTML

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

...

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/

...