Swagger Hub

¿Qué es Swagger Hub?

La plataforma para el diseño y la documentación de API con OpenAPI

Diseño de API más rápido y estandarizado

• Potente editor para el diseño de la OEA

Cree API nuevas y existentes en un editor intuitivo basado en navegador diseñado para una iteración rápida del contrato Swagger/OpenAPI. Valide y guarde su diseño rápidamente, con una experiencia de edición sin complicaciones para diseñar API que maximicen la adopción por parte de los consumidores.

• Definir y aplicar directrices de estilo

Asegúrese de que todas sus API cumplan con los estándares de diseño de su organización con la estandarización de API integrada. No más páginas wiki, documentos de GitHub o PDF a los que tus desarrolladores necesitan hacer referencia para mantener la coherencia de estilo en sus API.

• Diseño de API de aceleración con componentes reutilizables

Elimine la necesidad de reescribir continuamente todas las rutas y respuestas repetidas al definir su API. En SwaggerHub, puede almacenar los estilos comunes de su organización como componentes reutilizables, que se pueden reutilizar en todas sus API.

Trabajar mejor juntos

• Informar y realizar un seguimiento de los problemas

Deliberar sobre nuevas ideas, resaltar problemas y resolverlos juntos a través de los comentarios de SwaggerHub. Las revisiones de SwaggerHub también sirven como un sistema de tickets, lo que significa que siempre puede rastrear problemas y conversaciones abiertas para resolver y priorizar en consecuencia.

• Estandarice su flujo de trabajo de API

Elimine los dolores de cabeza del seguimiento de las actualizaciones de diferentes miembros del equipo en múltiples plataformas de desarrollo. Brinde a los desarrolladores la independencia que desean y diseñe la supervisión que necesitan para realizar un seguimiento de los cambios y recibir notificaciones cuando se realicen actualizaciones.

• Integre con el ciclo de vida de su API

Desde la sincronización perfecta entre hosts de control de código fuente como GitHub, GitLab y Bitbucket, la implementación de API para plataformas APIM como AWS, Azure e IBM, y los disparadores de compilación externos que utilizan webhooks personalizados, SwaggerHub está diseñado para que las organizaciones lleven el desarrollo de API al siguiente nivel.

Facilite el ciclo de vida de su API

• Definiciones de API de host

SwaggerHub actúa como una fuente real para alojar y descubrir sus definiciones de API. Organice las definiciones de API en un repositorio interno y organice las API en función de equipos, proyectos u otras consideraciones arquitectónicas.

• Administrar versiones de API

Los cambios en sus servicios RESTful son inevitables, y facilitar la versión de las API existentes puede ser un proceso propenso a errores. SwaggerHub le permite actualizar y publicar continuamente nuevas versiones de API para que sus consumidores puedan acceder a la versión correcta en el momento adecuado.

• Mejorar la supervisión y la gobernanza

A medida que sus API evolucionan y se realizan cambios, es importante mantener a las partes interesadas alineadas. SwaggerHub proporciona a los arquitectos y al personal de API la supervisión que necesitan para realizar un seguimiento de los cambios, resolver problemas y estandarizar la forma en que se desarrollan internamente las API.

• Integre con el ciclo de vida de su API

El diseño y la documentación son solo partes del ciclo de vida de la API más grande, y aunque SwaggerHub se especializa en ellos, también permite a los equipos conectarse sin problemas a otras soluciones de software externas. Ya sea que esté implementando en puertas de enlace de API, sincronizando con repositorios de código del lado del servidor o conectándose a herramientas de prueba, SwaggerHub se adapta perfectamente a su flujo de trabajo existente.

Documentación de API interactiva alojada

• Documentar como profesional

SwaggerHub representa visualmente su contrato de API como un documento totalmente interactivo para la funcionalidad en vivo, lo que permite a sus consumidores finales saber exactamente cómo funcionará y se comportará su API antes de integrarla en su código.

• Generar automáticamente documentación de la OEA

¿Está buscando comenzar rápidamente a documentar sus API con OAS en SwaggerHub? Aproveche el Swagger Inspector integrado para generar documentación de la OEA a partir de sus API existentes. En menos de 3 pasos, tendrá una definición de OEA generada y alojada en SwaggerHub.

• Importación y documentación de la API de host

¿Tiene una definición existente de la OEA para su API? Importe su API existente basada en la OEA para obtener documentación adicional desde la web o su sistema de archivos local. Las definiciones de API y su documentación se importan completamente a la nube durante la importación, lo que permite a su equipo agregar contenido y características avanzadas a la API.

• Gestione el acceso en un entorno seguro

La documentación de la API solo es útil cuando un consumidor de API puede acceder a sus documentos y obtener la información que necesita para trabajar con la API. SwaggerHub le permite alojar documentación de API en la nube y proporcionar acceso seguro a través del control de permisos e integraciones integradas con puertas de enlace de API.

Requisitos del sistema

Recomendado:

• Intel Core i5 o i7 (tercera generación o posterior) o un procesador AMD equivalente.
• 6 GB de RAM o más.
• 500 MB de espacio libre en disco para la instalación.

Mínimo:

• Intel Core i3 (tercera generación o posterior).
• 4 GB de RAM.
• 500 MB de espacio libre en disco para la instalación (ReadyAPI y HermesJMS).