/
Convert Swagger API Definition to WADL

The LMS API documentation is of format Swagger. In order explicitly convert that definition into WADL, some tools and steps are needed for the conversion.

Required Tools

Workflow

  1. Get the Swagger URL from the LMS site

    1. Open the LMS site with /help attached at the end of the URL. This will open the API documentation (e.g. https://myLms.marinels.com/help)

    2. Copy the swagger URL from the top (e.g. https://myLms.marinels.com/swagger/docs/v1) - we will need the URL later

  2. Load Swagger URL into the Swagger Inspector

    1. Open https://inspector.swagger.io/builder in a browser

    2. Make sure the drop down Definition and GET are selected

    3. Paste the swagger URL (e.g. https://myLms.marinels.com/swagger/docs/v1) into the text field next to the GET drop down

    4. Click SEND. This will load the swagger definition from the LMS site

    5. Save the content from the RESPONSE field as a json file on disk (make sure SHOW HEADERS is not active)

  3. Convert Swagger file into WADL

    1. Open the program SoapUI

    2. Create a new project with File > New SOAP Project

    3. In the Navigator tab right click the new project and select Import Swagger/OpenAPI Definition

    4. Browse to the previously saved json file and click OK. This will load all API endpoints into the project

    5. Right click the entry MarineLMS.Web.Main in the navigator and select Export WADL

    6. Select a directory into which the WADL file should be created and click Save

    7. A new file will be created in the selected directory (file extension .wadl)