The presentation is displayed by a Web browser:
Either accessing the resource http://mydomain.com/<Swagger2Feature$basePath>/services and then clicking on the swagger link suggested, for example: http://localhost:8080/awsklbadel/ws/services displays the following page:
- Or directly accessing the resource http://mydomain.com/<Swagger2Feature$basePath>/api-docs?url=<Swagger2Feature$basePath>/swagger.json, for example: http://localhost:8080/awsklbadel/ws/api-docs?url=/awsklbadel/ws/swagger.json
Note: the presentation is only available when the 'supportSwaggerUi' property of the"swagger2Feature"; bean in the beans.xml file is set to the value 'true'.
The swagger ui interface displays the web services of your web application.
The section Models displays the data models used in the shown web services payloads.
If your services are secured by the JWT, you can enter it by clicking the Authorize button.
Note: on a site created using version 13, the Authorize button may not be visible.
This can be solved by changing the "resourcePackage" property of the "swagger2Feature" bean in the beans.xml file to add the "com.hardis.adelia.webservice" (value= "com.hardis.adelia.webservice,xxx.yyy.zzz") package to its "value".
You can see the operation details by clicking on it:
In order to execute the operation, you need to click the Try it out button and your data:
Then click on the Execute button in order to execute the operation and obtain the response:
