Swagger Hub

Swagger Hub

A plataforma para design e documentação de API com OpenAPI

Design de API mais rápido e padronizado

• Poderoso editor para design da OEA

Crie apis novas e existentes em um editor intuitivo baseado em navegador projetado para uma rápida iteração do contrato Swagger/OpenAPI. Valide e salve seu design rapidamente, com uma experiência de edição sem problemas para projetar APIs que maximizam a adoção do consumidor.

• Defina e imponha diretrizes de estilo

Certifique-se de que todas as suas APIs cumpram seus padrões de design organizacional com padronização de API incorporada. Sem mais páginas wiki, documentos do GitHub ou PDFs que seus desenvolvedores precisam fazer referência para manter a consistência de estilo em suas APIs.

• Projeto de API de aceleração com componentes reutilizáveis

Remova a necessidade de reescrever continuamente todos os caminhos e respostas repetidos ao definir sua API. No SwaggerHub, você pode armazenar os estilos comuns da sua organização como componentes reutilizáveis, que podem ser reutilizados em todas as suas APIs.

Trabalhem melhor juntos

• Relatar e rastrear problemas

Deliberar sobre novas ideias, destacar problemas e resolvê-las em conjunto através de comentários do SwaggerHub. As avaliações do SwaggerHub também servem como um sistema de bilhetagem, o que significa que você sempre pode acompanhar questões e conversas abertas para resolver e priorizar de acordo.

• Padronize seu fluxo de trabalho de API

Remova as dores de cabeça de rastrear atualizações de diferentes membros da equipe em várias plataformas de desenvolvimento. Dê aos desenvolvedores a independência que eles querem e arquitete a supervisão que eles precisam para acompanhar as mudanças e ser notificados quando as atualizações forem feitas.

• Integre-se com o ciclo de vida da sua API

A partir da sincronização perfeita entre hosts de controle de origem como GitHub, GitLab e Bitbucket, implementação de API para plataformas APIM como AWS, Azure e IBM e gatilhos de compilação externos usando webhooks personalizados, o SwaggerHub foi projetado para que as organizações levem o desenvolvimento de API para o próximo nível.

Facilite seu ciclo de vida da API

• Definições de API de host

O SwaggerHub atua como uma fonte real para hospedar e descobrir suas definições de API. Organize as definições de API em um repositório interno e organize APIs com base em equipes, projetos ou outras considerações arquitetônicas.

• Gerenciar versões de API

As alterações em seus serviços RESTful são inevitáveis, e facilitar a versão das APIs existentes pode ser um processo propenso a erros. O SwaggerHub permite que você atualize e publique continuamente novas versões de APIs para que seus consumidores possam acessar a versão certa no momento certo.

• Melhorar a supervisão e a governança

À medida que suas APIs evoluem e mudanças são feitas, é importante manter as partes interessadas alinhadas. O SwaggerHub fornece aos arquitetos e à equipe de API a supervisão de que precisam para rastrear mudanças, resolver problemas e padronizar como as APIs são desenvolvidas internamente.

• Integre-se com o ciclo de vida da sua API

Design e documentação são apenas partes do ciclo de vida maior da API, e embora o SwaggerHub se especialize neles, ele também capacita as equipes a se conectarem perfeitamente a outras soluções de software externos. Se você está implantando em gateways de API, sincronizando com repositórios de código do lado do servidor ou se conectando a ferramentas de teste, o SwaggerHub se encaixa perfeitamente no seu fluxo de trabalho existente.

Documentação de API interativa hospedada

• Documento como profissional

O SwaggerHub torna visualmente seu contrato de API como um documento totalmente interativo para funcionalidade ao vivo, permitindo que seus consumidores finais saibam exatamente como sua API funcionará e se comportará antes de integrá-lo ao seu código.

• Gerar automaticamente documentação da OEA

Você está procurando começar a documentar rapidamente suas APIs com o OAS no SwaggerHub? Aproveite o Inspetor de Swagger integrado para gerar documentação da OEA a partir de suas APIs existentes. Em menos de 3 passos, você terá uma definição de OEA gerada e hospedada no SwaggerHub.

• Importação e documentação da API do host

Você tem uma definição de OEA existente para sua API? Importe sua API baseada em OAS existente para obter documentação adicional da Web ou do seu sistema de arquivos local. As definições de API e sua documentação são totalmente importadas para a nuvem durante a importação, permitindo que sua equipe adicione conteúdo e recursos avançados à API.

• Gerenciar o acesso em um ambiente seguro

A documentação da API só é útil quando um consumidor de API pode acessar seus documentos e obter as informações de que precisa para trabalhar com a API. O SwaggerHub permite que você hospede a documentação de API na nuvem e forneça acesso seguro através do controle de permissões e integrações integradas com gateways de API.

Requisitos do sistema

Recomendado:

• Intel Core i5 ou i7 (terceira geração ou posterior) ou um processador AMD equivalente.
• 6 GB de RAM ou mais.
• 500MB de espaço livre em disco para instalação.

Mínimo:

• Intel Core i3 (terceira geração ou posterior).
• 4 GB de RAM.
• 500MB de espaço livre em disco para instalação (ReadyAPI e HermesJMS).