Prós e Contras de SwaggerHub

A parte do SwaggerHub que mais gostei é que é a melhor ferramenta disponível no mercado para design e teste de APIs; também pode ser usada como uma ferramenta de depuração. A resposta ou mensagem de erro mostrada é de excelente utilidade, a segunda coisa que gostei é que posso criar uma equipe e compartilhar toda a coleção com um único clique e a interface e experiência do usuário também são muito simples e boas, com todos os controladores no mesmo formato. Análise coletada por e hospedada no G2.com.

Acho que não há nada que eu não goste no SwaggerHub, mas há uma coisa que eu gostaria que pudesse ser mudada: que se tornasse mais fácil de implementar no código, embora haja documentos disponíveis no site, encontrei um problema que não foi mencionado em lugar nenhum, que é que eu não consegui implementar Swagger e Melody juntos no mesmo projeto. Análise coletada por e hospedada no G2.com.

Possui uma interface amigável e é fácil de usar, podemos verificar a API onde está funcionando corretamente ou não e é muito fácil criar a Página Swagger onde todas as APIs no código-fonte, podemos verificar e a resposta de cada API podemos ver qual é o erro que está causando e outras informações relacionadas que são úteis para depuração. Também é usado para fins de documentação que outros desenvolvedores podem entender facilmente. Análise coletada por e hospedada no G2.com.

Às vezes, o servidor do SwaggerHub está fora do ar, não sei qual é o problema e o suporte ao cliente precisa melhorar, mas, além disso, é uma das melhores ferramentas para verificar as APIs. Análise coletada por e hospedada no G2.com.

É simples de usar e a interface é muito suave, podemos personalizar a aparência e a documentação conforme desejamos e é a melhor ferramenta para testar se a API está funcionando corretamente ou não. Análise coletada por e hospedada no G2.com.

Não há nada a desgostar, funciona como esperado, mas eles precisam adicionar mais recursos para competir com outras ferramentas de software de verificação de API. Análise coletada por e hospedada no G2.com.

É muito útil projetar uma API padronizada com diretrizes padrão da indústria e também com opções flexíveis para desenvolvedores. Os desenvolvedores podem fazer upload do arquivo YAML com o Swagger Editor ou usar o SwaggerHub Visual Editor para atualizar as informações da API sem precisar entender a sintaxe YAML.

Ele fornece ótimos plugins para integrar com o Visual Studio Code Editor e IntelliJ IDEA. Isso permite que os designers visualizem e editem suas APIs e domínios diretamente de seus ambientes de desenvolvimento favoritos, permitindo que sejam mais produtivos com uma experiência de edição sem complicações.

Ele também suporta diferentes linguagens como Java, Python e JavaScript para gerar os arquivos do servidor. Por exemplo, ao desenvolver um projeto Java Spring Boot, o Swagger pode gerar os arquivos java necessários, como controladores e modelos, e podemos fazer uso direto desse material gerado automaticamente ao escrever nossa lógica de negócios. Consulte: https://editor.swagger.io/ Análise coletada por e hospedada no G2.com.

É literalmente benéfico, mas ainda há algumas coisas que podem ser melhoradas. Tais como:

Ao gerar um projeto baseado em Java Spring usando o Swagger Editor aqui: https://editor.swagger.io/ muitas dependências inúteis serão incluídas no arquivo pom.xml.

A propósito, é capaz de gerar os documentos, mas um novo recurso para converter esses documentos em páginas wiki pode adicionar mais valor a este produto. Análise coletada por e hospedada no G2.com.

SwaggerHub fornece uma interface de usuário mais simples para projetar e testar API de forma eficiente. A depuração de erros também se torna mais acessível com formatos de erro adequados em um único painel. Podemos monitorar o desempenho de todas as APIs se houver quaisquer problemas ou erros em alguma delas. Ele também permite fazer a documentação adequada dessas APIs para referências de desenvolvimento. Análise coletada por e hospedada no G2.com.

Até onde usamos, não vejo nenhum problema ou preocupação significativa ao usar o SwaggerHub. Há momentos em que os sistemas ficam instáveis, mas isso acontece uma ou duas vezes por mês. Então podemos ignorar esses casos. Análise coletada por e hospedada no G2.com.

SwaggerHub é uma ótima plataforma para nossas necessidades de design e definição de API e para gerenciá-las ao longo de seu ciclo de vida. Ele se integra perfeitamente com várias ferramentas Swagger, como API Editor, Validator e Codegen, e as reúne em uma única plataforma onde podemos colaborar efetivamente na funcionalidade do nosso fluxo de trabalho de negócios. Ele implementa especificações OpenAPI para gerenciamento de API e simplifica a lógica de implementação para nossas interações de serviço remoto. Análise coletada por e hospedada no G2.com.

Seu recurso de modelagem de caminho utiliza efetivamente várias expressões de modelo que são devidamente delimitadas e representadas dinamicamente usando seus parâmetros de caminho integrados. Podemos compor especificações de documentos OpenAPI tanto em JSON quanto em scripts YAML, pois ele suporta ambos. Ele também inclui expressões-chave que ajudam na avaliação em tempo de execução e identificam a URL que precisa ser usada para nossa solicitação de callback, então não sinto nenhuma desvantagem ao trabalhar na plataforma SwaggerHub. Análise coletada por e hospedada no G2.com.

É muito fácil de usar e integrar com serviços REST usando Java, simples de usar com toda a funcionalidade, não precisa instalar o pesado Postman, retorna todos os contratos de API e endpoints disponíveis. Análise coletada por e hospedada no G2.com.

Não há nada para não gostar, acho esta ferramenta muito útil e fácil de usar. É indispensável no kit de qualquer desenvolvedor de API. Não sei o que estávamos fazendo sem o swagger antes. Análise coletada por e hospedada no G2.com.

A melhor parte é a documentação da API de automação para todos os serviços, é muito útil para clientes e desenvolvedores usarem isso para entender e obter todas as coisas rapidamente. Análise coletada por e hospedada no G2.com.

É desajeitado e não funciona por algum tempo para todos os passos dos usuários, curvas de aprendizado, problemas com a versão premium e problemas de compatibilidade e problemas para adicionar tokens todas as vezes. Análise coletada por e hospedada no 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. Análise coletada por e hospedada no 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. Análise coletada por e hospedada no G2.com.

Swagger UI é bom para que possamos entender facilmente qual é a necessidade de desenvolver um endpoint específico e até mesmo é bom para que as pessoas de QA entendam todos os dados necessários para um endpoint específico, para que possam testá-lo sem perguntar ao desenvolvedor. Análise coletada por e hospedada no G2.com.

minimização e expansão do bloco específico da API podem ser aprovadas, ou seja, quando temos muitos endpoints listados no swagger, é difícil navegar entre diferentes endpoints. Análise coletada por e hospedada no G2.com.