La présentation d'un service Web REST s'affiche dans un navigateur Web :
- soit via la ressource http://mydomain.com/<openApiFeature$basePath>/services, puis en cliquant sur lien swagger proposé.
Par exemple : http://localhost:8080/awsbdcadel/ws/services affiche la page suivante :
- Soit directement via la ressource http://mydomain.com/<openApiFeature$basePath>/api-docs?url=<openApiFeature$basePath>/openapi.json.
Par exemple : http://localhost:8080/awsbdcadel/ws/api-docs?url=/awsbdcadel/ws/openapi.json.
Remarque : la présentation n'est disponible que si, dans le fichier beans.xml, la propriété "supportSwaggerUi" du bean "openApiFeature" a la valeur "true".
L'interface swagger ui affiche les services web de votre application web.
La section Models affiche les modèles de données utilisés dans les payloads des services web présentés.
Le bouton Authorize permet de saisir le jeton JWT dans le cas où vos services sont sécurisés en JWT.
En cliquant sur une opération, vous accédez à son détail :
Pour pouvoir exécuter l'opération, cliquez sur le bouton Try it out, pour pouvoir saisir vos données :
Cliquez ensuite sur le bouton Execute pour lancer l'exécution de l'opération et voir la réponse :
