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
Swagger Inspector (online - no login required): https://inspector.swagger.io/builder
SoapUI Open Source (local installation required): Download from https://www.soapui.org/tools/soapui
Note: ignoreReadyAPI
Workflow
Get the Swagger URL from the LMS site
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)Copy the swagger URL from the top (e.g. https://myLms.marinels.com/swagger/docs/v1) - we will need the URL later
Load Swagger URL into the Swagger Inspector
Open https://inspector.swagger.io/builder in a browser
Make sure the drop down
Definition
andGET
are selectedPaste the swagger URL (e.g. https://myLms.marinels.com/swagger/docs/v1) into the text field next to the
GET
drop downClick
SEND
. This will load the swagger definition from the LMS siteSave the content from the
RESPONSE
field as a json file on disk (make sureSHOW HEADERS
is not active)
Convert Swagger file into WADL
Open the program
SoapUI
Create a new project with
File
>New SOAP Project
In the
Navigator
tab right click the new project and selectImport Swagger/OpenAPI Definition
Browse to the previously saved json file and click
OK
. This will load all API endpoints into the projectRight click the entry
MarineLMS.Web.Main
in the navigator and selectExport WADL
Select a directory into which the WADL file should be created and click
Save
A new file will be created in the selected directory (file extension
.wadl
)