Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Correct Swagger UI link


Table of Contents


Swagger documentation

SDC Catalog External API

to access Swagger for SDC external API's

    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. 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

...

Code Block
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/

...