restful url - example - ¿Cómo empiezo con swagger-ui?

swagger ui html

Question

¿Qué es swagger-ui y para qué sirve?

¿Hay buenos recursos para comenzar con swagger-ui? ¿Algún buen tutorial, blog o libro?

También visito http://swagger.io/ pero necesito más información.

por favor guíame. Gracias en adv

Answer 1

Swagger UI es una herramienta que toma los archivos de especificación de Swagger, los presenta visualmente y le permite ejecutar operaciones.

Swagger es una especificación para documentar y describir las API REST. La especificación se puede encontrar aquí: https://github.com/swagger-api/swagger-spec/ . El repositorio contiene la especificación en sí, el esquema json, las muestras, etc. El README principal del repositorio también lo dirige a herramientas adicionales que incluyen bibliotecas y marcos para producir sus especificaciones.

Cuando se trata de crear la especificación Swagger, puede usar uno de los marcos e integrarlo con el código existente para generar automáticamente dicha documentación.

Si no tiene una aplicación existente o prefiere documentarla manualmente, puede usar la herramienta Swagger-Editor o el editor de texto de su elección.