Pros y Contras de SwaggerHub

Amigable para el usuario. Fácil de integrar con el código. Reseña recopilada por y alojada en G2.com.

todavía hay actualizaciones en curso. necesito un estándar Reseña recopilada por y alojada en G2.com.

Estamos documentando la API con. La forma fácil de integrar y generar archivos SDK de API es manejar todos los parámetros requeridos para la API, como el token de autenticación, etc. El paquete npm OpenAPI ayuda mucho a generar archivos SDK. Reseña recopilada por y alojada en G2.com.

En cuanto a la seguridad, tenemos grandes preocupaciones. Como es una oferta en la nube, tenemos que añadir todos los tokens y credenciales de seguridad en el portal del hub para verificar si la API funciona o no. Esto puede ser una amenaza al añadir esos detalles en un sitio de terceros. Reseña recopilada por y alojada en G2.com.

Me gusta cómo convierte el archivo YAML de la documentación de la API en un entorno de prueba de API funcional, incluyendo cargas útiles, autorización, etc. Y también la gestión de versiones del archivo de documentos. Reseña recopilada por y alojada en G2.com.

Modificar el archivo YAML para obtener el resultado deseado causa dolor. Porque la indentación de los archivos YAML juega un papel importante. Si algo no está en el formato adecuado, todo el documento se colapsará. Reseña recopilada por y alojada en G2.com.

Un swagger es en realidad una herramienta increíble para documentar automáticamente tu API una vez que está integrada, proporciona una gran interfaz de usuario para ver la estructura y el esquema de la API y ejecuta comandos directamente. Reseña recopilada por y alojada en G2.com.

estamos usando sails.js como un marco de backend y la integración de swagger con sails.js es un proceso realmente difícil y doloroso, la falta de tutoriales en internet y la documentación para integrar con sails no es tan buena en realidad, ¡pero una vez que está integrado, después de eso funciona sin problemas! Reseña recopilada por y alojada en G2.com.

Como consumidor de API, puedes extraer las definiciones de las APIs y utilizarlas. Para cualquier diseño de API, la documentación es más crítica que el código porque todos los desarrolladores se centrarán en los documentos; solo Swaggerhub tiene una gran facilidad para construir documentos. La capacidad de crear organizaciones es muy útil. Por ejemplo, si estás trabajando para múltiples organizaciones, puedes llevar un seguimiento de tu trabajo de manera independiente. Reseña recopilada por y alojada en G2.com.

La interfaz de usuario podría ser confusa para los nuevos desarrolladores. He visto que algunas de las documentaciones de la API contienen caracteres basura también. Así que se requiere mucho trabajo en esa área. Además, las pruebas de API no son posibles. Reseña recopilada por y alojada en G2.com.

Facilita compartir o usar juntos para proyectos colaborativos para el equipo y dentro del grupo, también es útil para las organizaciones cuando quieren documentar la API. Me siento elemental al comunicarme sobre la versión del punto final de la API entre varios interesados y equipos usando la sección de comentarios de swaggerHub. Swagger Hub es una plataforma de software de código abierto que cualquier individuo o empresa puede usar de forma gratuita. Y también puede usar el soporte de swaggerHub para su equipo, aunque swaggerHub cobra algunos dólares por sus características de paquete de equipo y soporte de manera mensual y anual. Reseña recopilada por y alojada en G2.com.

Crear documentación de API desde cero no es muy amigable para principiantes, también hay una falta en las pruebas de los puntos finales de la API. Al actualizar o crear nuevas entradas de API, no es muy fácil mantener la sangría, y tomó más tiempo del esperado. Reseña recopilada por y alojada en G2.com.

Muy fácil manera de compartir los documentos relacionados con la API sin ninguna intervención manual. solo haz la codificación y el documento se generará automáticamente. Reseña recopilada por y alojada en G2.com.

La interfaz de usuario necesita ser mejorada. Debería permitir la configuración de variables de entorno para que, cuando haya un cambio en los detalles del servidor de implementación, simplemente se cambien los detalles de las variables. Reseña recopilada por y alojada en G2.com.

1. La documentación de la API principal automatiza la documentación de Swagger UI y proporciona todos los detalles de la API, desde la carga útil hasta la respuesta.

2. La vida del desarrollador/QA es fácil mientras prueba las APIs Rest.

3. API segura mediante soporte de autenticación basada en tokens, para que no esté expuesta al mundo exterior. Reseña recopilada por y alojada en G2.com.

1. Nada como tal, pero es difícil probar OpenApi.

2. Sin leer la documentación es difícil de usar, pero una vez que lo entiendes, funciona de maravilla. Reseña recopilada por y alojada en G2.com.

Una herramienta de documentación de código abierto, gratuita y fácil de usar para la API desde donde cualquiera puede verificarla y probarla. La documentación de la API es muy sencilla, de modo que al hacer la codificación, el documento relacionado se generará automáticamente. Reseña recopilada por y alojada en G2.com.

No hay forma de escribir los casos de prueba. Mejor si permite la integración para el software de terceros. Reseña recopilada por y alojada en G2.com.

Lo que más me gusta de SwaggerHub es la posibilidad de usarlo como un repositorio y la capacidad de validar mis scripts al subirlos, y el caso de pegar en formato JSON o YAML. Reseña recopilada por y alojada en G2.com.

Por ahora, no he encontrado ninguna desventaja que mencionar. La verdad me ha funcionado. Reseña recopilada por y alojada en G2.com.