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:

Image Modified

SDC Onboarding Internal API's

to access Swagger:

    1. in the browser go to http://<onboarding docker ip>:8081/api-docs/#/

SDC Catalog Internal API's

to access Swagger:

    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

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

and then run:

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

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/

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