Puede utilizar un asistente para generar un archivo swagger.json de plantilla para especificar una interfaz de programación de aplicaciones (API) REST (Representational State Transfer). El asistente está habilitado para proyectos que tienen como destino un servidor de
Liberty y utilizan Web 2.5 y posteriores.
Acerca de esta tarea
Importante: Aplicable a Liberty, Liberty Core
Procedimiento
- Cree un proyecto web que tenga como destino un servidor de Liberty.
Para obtener más información sobre cómo crear proyectos web, consulte Creación de proyectos web.
- Cree un archivo de definición de la API REST Swagger mediante una de las opciones
siguientes:
- Seleccione
,
y seleccione Archivo de definición API REST Swagger en la sección
Definición de API REST.
- Pulse el botón derecho del ratón en un proyecto y seleccione
.
- Seleccione el tipo de archivo JSON (JavaScript Object Notation) que desea crear:
- Para crear un archivo con todos los elementos Swagger de nivel superior que son necesarios, seleccione Crear un archivo swagger.json de plantilla.
- Para crear un archivo con contenido de ejemplo para definiciones comunes, como GET, PUT y POST, seleccione Crear un archivo swagger.json de ejemplo.
- Seleccione una ubicación para el archivo que está creando:
- Pulse Finalizar.
Resultados
Las herramientas generan un archivo swagger.json en la carpeta
WebContent/META-INF para su proyecto web. El archivo se abre en el editor de JSON predeterminado.