Pros y Contras de SwaggerHub

La parte de SwaggerHub que más me gustó es que es la mejor herramienta disponible en el mercado para el diseño y prueba de API; también se puede utilizar como una herramienta de depuración. La respuesta o mensaje de error son de excelente utilidad, la segunda cosa que me gustó es que puedo crear un equipo y compartir toda la colección con un solo clic y la interfaz de usuario y la experiencia de usuario también son muy simples y buenas, con todos los mismos controladores en un solo formato. Reseña recopilada por y alojada en G2.com.

No creo que haya nada que no me guste de SwaggerHub, pero hay una cosa que desearía que pudiera cambiarse y es que si se vuelve más fácil de implementar en el código, aunque hay documentos disponibles en el sitio web, encontré un problema que no se mencionaba en ningún lugar, y es que no pude implementar Swagger y Melody juntos en el mismo proyecto. Reseña recopilada por y alojada en G2.com.

Tiene una interfaz de usuario amigable y es fácil de usar, podemos verificar si la API está funcionando correctamente o no y es muy fácil crear la página Swagger donde están todas las APIs en el código fuente, podemos verificar y la respuesta de cada API podemos ver cuál es el error que está causando y otra información relacionada que es útil para la depuración. También se utiliza con fines de documentación que otros desarrolladores pueden entender fácilmente. Reseña recopilada por y alojada en G2.com.

A veces el servidor de SwaggerHub está caído, no sé cuál es el problema y el soporte al cliente necesita mejorar, pero aparte de esto, es una de las mejores herramientas para verificar las API. Reseña recopilada por y alojada en G2.com.

Es simple de usar y la interfaz es muy fluida, podemos personalizar la apariencia y la documentación según queramos y es la mejor herramienta para probar si la API funciona correctamente o no. Reseña recopilada por y alojada en G2.com.

No hay nada que no me guste, funciona como se esperaba, pero necesitan agregar más funciones para competir con otras herramientas de software de verificación de API. Reseña recopilada por y alojada en G2.com.

Es muy útil diseñar una API estandarizada con directrices estándar de la industria y también con opciones flexibles para desarrolladores. Los desarrolladores pueden cargar el archivo YAML con Swagger Editor o usar el SwaggerHub Visual Editor para actualizar la información de la API sin tener que entender la sintaxis YAML.

Proporciona buenos complementos para integrarse con Visual Studio Code Editor e IntelliJ IDEA. Esto permite a los diseñadores ver y editar sus APIs y dominios directamente desde sus entornos de desarrollo favoritos, lo que les permite ser más productivos con una experiencia de edición sin complicaciones.

También admite diferentes lenguajes como Java, Python y JavaScript para generar los archivos del servidor. Por ejemplo, al desarrollar un proyecto Java Spring Boot, Swagger puede generar los archivos java requeridos como controladores y modelos, y podemos hacer uso directo de este material autogenerado al escribir nuestra lógica de negocio. Reseña recopilada por y alojada en G2.com.

Es literalmente beneficioso, pero aún se pueden mejorar algunas cosas. Como por ejemplo:

Al generar un proyecto basado en Java Spring usando Swagger Editor aquí: https://editor.swagger.io/ se incluirán muchas dependencias inútiles en el archivo pom.xml.

Por cierto, es capaz de generar los documentos, pero una nueva función para convertir esos documentos en páginas wiki puede agregar más valor a este producto. Reseña recopilada por y alojada en G2.com.

SwaggerHub proporciona una interfaz de usuario más sencilla para diseñar y probar API de manera eficiente. La depuración de errores también se vuelve más accesible con formatos de error adecuados en un solo panel. Podemos monitorear el rendimiento de todas las API si hay algún problema o error en alguna de ellas. También permite hacer una documentación adecuada de estas API para referencias de desarrollo. Reseña recopilada por y alojada en G2.com.

Hasta donde lo hemos utilizado, no veo ningún problema o preocupación significativa al usar SwaggerHub. Hay momentos en que los sistemas se vuelven problemáticos, pero esto ocurre una o dos veces al mes. Así que podemos ignorar tales casos. Reseña recopilada por y alojada en G2.com.

SwaggerHub es una gran plataforma para nuestros requisitos de diseño y definición de API y para gestionarlos a lo largo de su ciclo de vida. Se integra perfectamente con múltiples herramientas de Swagger, como API Editor, Validator y Codegen, y las reúne en una sola plataforma donde podemos colaborar efectivamente en la funcionalidad de nuestro flujo de trabajo empresarial. Implementa especificaciones OpenAPI para la gestión de API y simplifica la lógica de implementación para nuestras interacciones de servicio remoto. Reseña recopilada por y alojada en G2.com.

Su función de plantillas de ruta utiliza eficazmente varias expresiones de plantilla que están debidamente delimitadas y representadas dinámicamente utilizando sus parámetros de ruta integrados. Podemos componer especificaciones de documentos OpenAPI ya sea en JSON o en scripts YAML, ya que admite ambos. También incluye expresiones clave que ayudan en la evaluación en tiempo de ejecución e identifican la URL que se debe usar para nuestra solicitud de devolución de llamada, por lo que no siento ninguna desventaja al trabajar en la plataforma SwaggerHub. Reseña recopilada por y alojada en G2.com.

Es muy fácil de usar e integrar con servicios REST usando Java, simple de usar con toda la funcionalidad, no es necesario instalar un pesado Postman, devuelve todos los contratos de API y los endpoints disponibles. Reseña recopilada por y alojada en G2.com.

No hay nada que no me guste, encuentro esta herramienta muy útil y fácil de usar. Es imprescindible en el kit de cualquier desarrollador de API. No sé qué estábamos haciendo sin swagger antes. Reseña recopilada por y alojada en G2.com.

La mejor parte es la documentación de la API de automatización para todos los servicios, es muy útil para que los clientes y desarrolladores la utilicen para entender y obtener todas las cosas rápidamente. Reseña recopilada por y alojada en G2.com.

Es torpe y no funciona durante algún tiempo para todos los pasos de usuario, curvas de aprendizaje, problemas de la versión premium y problemas de compatibilidad y problemas para agregar tokens cada vez. Reseña recopilada por y alojada en G2.com.

Can customize each field by giving its own definition.

Has sole control over the one who manages this documentation.

Can update the documentation based on further needs.

An easy way to give access and provide necessary information on the API workflow & its nature. Reseña recopilada por y alojada en G2.com.

Time-consuming & costly to prepare.

Requires an immense amount of work if any changes needs to be done with the existing workflow.

Needs to be patient with the documentation of each API definition & structure.

Every code return for the definition structure must follow strict syntax else tracing errors is difficult. Reseña recopilada por y alojada en G2.com.

Swagger UI es bueno para que podamos entender fácilmente cuál es el requisito para desarrollar un endpoint en particular e incluso es bueno para que las personas de QA comprendan todos los datos necesarios para un endpoint en particular, de modo que puedan probarlo sin preguntar al desarrollador. Reseña recopilada por y alojada en G2.com.

minimización y expansión del bloque particular de la API pueden ser aprobadas, es decir, cuando tenemos muchos puntos finales listados en swagger, es difícil navegar entre diferentes puntos finales. Reseña recopilada por y alojada en G2.com.