Pros y Contras de SwaggerHub

La interfaz de usuario es simple y limpia, proporciona facilidad de acceso a nuevos usuarios. El token de autenticación se puede configurar fácilmente. Lo uso en mis actividades diarias de desarrollo. Las API que escribí, las pruebo usando swagger. Después de probar mis API a través de swagger, comienzo la integración con las API del frontend. Con alguna configuración adicional, swagger persiste el token de autenticación, cambia el tema y también muestra el tiempo de respuesta. Reseña recopilada por y alojada en G2.com.

Si recargamos swagger, entonces todo el cuerpo de solicitud que hicimos anteriormente para las API se borrará, deberíamos tener una opción de persistencia para guardar solicitudes. Por ejemplo, postman admite guardar solicitudes, etc. La opción de filtro de Swagger no está a la altura. Reseña recopilada por y alojada en G2.com.

Me gusta porque puedo trabajar con otros compañeros de equipo desarrollando nuestra documentación en el mismo proyecto, me gusta porque podemos tener nuestras propias ramas para desarrollar, podemos buscar dependiendo de la frecuencia de actualización o buscar por nombre, es muy útil cuando el proyecto se vuelve muy grande y cuando trabajamos con mucha gente. Reseña recopilada por y alojada en G2.com.

No me gusta que no podamos ver de manera fácil qué cambios hacen nuestros compañeros de equipo en el documento de swaggerHub, este proceso necesita hacerse manualmente. Reseña recopilada por y alojada en G2.com.

Uso SwaggerHub con frecuencia para crear documentación de API.

Fácil de probar las API localmente antes de los despliegues.

Simple exportar el código al lenguaje de programación de mi elección y la implementación se hace fácil.

Capaz de probar la seguridad de la API con autenticación OAuth.

Fácil validar las solicitudes de API e integrar con otros sistemas.

Fácil copiar/descargar solicitudes curl. Reseña recopilada por y alojada en G2.com.

La versión gratuita tiene funciones limitadas.

Una vez que actualicemos el swagger, la carga útil de json se restablecerá a los valores predeterminados y los parámetros de consulta se borrarán.

Las opciones de colaboración en equipo son limitadas. Reseña recopilada por y alojada en G2.com.

Sus documentaciones estructuradas ayudan mucho al realizar cualquier integración. Reseña recopilada por y alojada en G2.com.

Su autorización, a veces se vuelve defectuosa y necesita ser reautorizada. Reseña recopilada por y alojada en G2.com.

Me gusta que sea accesible y me ayude a depurar más rápido. Reseña recopilada por y alojada en G2.com.

La interfaz de usuario no es tan buena. Me gustaría que fuera más fácil de usar. Reseña recopilada por y alojada en G2.com.

Ayuda a comprender el esquema y los puntos de datos, lo que nos ayuda a integrar servicios sin problemas. Reseña recopilada por y alojada en G2.com.

Sería genial si nos ayuda con descripciones de cada campo y si es un campo anulable o no. Reseña recopilada por y alojada en G2.com.

La principal ventaja es la generación automática de SDKs de cliente y servidor en varios idiomas, lo que acelera el proceso de desarrollo. Reseña recopilada por y alojada en G2.com.

No pude encontrar ninguna preocupación al usar Swagger Hub. Reseña recopilada por y alojada en G2.com.

Su integración con herramientas de DevOps es algo que me gusta mucho. Reseña recopilada por y alojada en G2.com.

Todavía no estoy seguro si hay algo que no me gusta. Reseña recopilada por y alojada en G2.com.

Easy to use and document various API routes and models. Can fast track API documentation. Reseña recopilada por y alojada en G2.com.

Interface is clunky, requires a lot of clicks to send a simple request. Models are poorly formatted and hard to read. Lack of support for things like recursive models. Reseña recopilada por y alojada en G2.com.

SwaggerHub proporciona herramientas robustas para diseñar tus APIs con la documentación adecuada y ejemplos. Puedes crear un nuevo documento vacío, elegir entre una gran cantidad de plantillas relacionadas o importar un proyecto existente. Algunas de las características que me gustan de Swagger son:

* Salida instantánea: Puedes ver instantáneamente la salida actual del script en cualquier momento.

* Flexible: También puedes editar visualmente el documento de salida además del código.

* Generación de base de código: Puedes generar un gran volumen de código y añadirlo a tu API.

* Ejemplos: Puedes añadir ejemplos para ejecuciones exitosas o errores.

* Colaboración: Puedes colaborar con miembros de tu equipo y miembros de otros equipos también. Reseña recopilada por y alojada en G2.com.

Algunos inconvenientes de SwaggerHub son:

* Falta de integración: Aunque SwaggerHub te proporciona conectores para la integración, no tiene suficiente integración para cubrir todas las API como SVN o Jira. Reseña recopilada por y alojada en G2.com.