Prós e Contras de SwaggerHub

É uma ferramenta de documentação excelente e genuína para a API compartilhar entre os clientes, onde eles podem verificá-la, testá-la, mantendo os resultados dos testes em tempo real com autenticação básica, bem como oauth2 outros. Tenho usado em meus projetos Laravel para a documentação. Análise coletada por e hospedada no G2.com.

toda vez que precisamos gerar os documentos, mesmo para pequenas alterações e os códigos precisam ser desenvolvidos cuidadosamente, o que não pode ser feito sem o conhecimento adequado, então é necessário uma pessoa treinada para isso. Análise coletada por e hospedada no G2.com.

Swaggerhub é uma ferramenta de documentação de API amigável para iniciantes que permite escrever documentação para suas APIs com facilidade. Uma das melhores coisas sobre o Swagger é que ele é facilmente compreensível, o que, do ponto de vista de um programador, economiza muito tempo. Instruções claras e documentação estão disponíveis para o uso fácil da ferramenta. Diferentes modelos disponíveis são um bônus adicional para o caso de uso. Análise coletada por e hospedada no G2.com.

Mais modelos podem ser introduzidos na comunidade. Mas, fora isso, cumpre muito bem o seu propósito. Análise coletada por e hospedada no G2.com.

Usa o formato YAML de arquivos OpenApi.

Funciona com formatos de requisição de API como SOAP, REST, GraphQL.

Permite fazer documentação facilmente. É chato, mas necessário.

Fornece a capacidade de selecionar a versão antes de publicá-la.

A equipe compartilhou a capacidade quando todos podem adicionar suas próprias ideias.

Integração sólida com repositórios como Github, Bitbucket, etc. Análise coletada por e hospedada no G2.com.

Mais integração com SoapUI, Postman e outras aplicações de terceiros.

É possível para não desenvolvedores operar com Swagger? Apenas testadores de QA podem lidar com isso.

Não forneça a capacidade de baixar documentação em outros formatos.

A interface do editor é bastante abrangente e tem maneiras de melhorar. Análise coletada por e hospedada no G2.com.

A documentação da API é fácil de ler, mesmo para quem não é desenvolvedor. A melhor característica é a colaboração em equipe, que facilita o trabalho. Análise coletada por e hospedada no G2.com.

SwaggerHub deveria ter mais recursos do ambiente completo de desenvolvimento de API. Deve-se comprar versões premium para criar APIs privadas e ter mais recursos adicionais. Análise coletada por e hospedada no G2.com.

The API designing tools make the developers more productive, In that raw using SwaggerHub with its open API support makes life easier. The best about SwaggerHub is it supports a wide range of APIs such as REST, SOAP, GraphQL, etc. Análise coletada por e hospedada no G2.com.

As a design tool, SwaggerHub is doing a great job in its fundamental areas. But there are still a few areas for improvement. A few of them are API specification version controlling, collaboration with the team, and mocking APIs Análise coletada por e hospedada no G2.com.

1. Muito bem mantido e bem documentado

2. 99% de tempo de atividade

3. Fácil de manter Análise coletada por e hospedada no G2.com.

A integração não é boa, mas eles estão trabalhando nisso. Análise coletada por e hospedada no G2.com.

Swagger Hub é uma ferramenta excelente para escrever as definições de API e a documentação para as APIs. O código é bastante direto. A renderização do código é brilhante, pois é muito descritiva e compreensível. A ferramenta é legível e pode ser projetada instantaneamente sem conhecimento prévio, pois fornece exemplos de como a ferramenta funciona com a entrada. O suporte fornecido pelo Swagger Hub é muito bom e o site deles oferece instruções claras e um guia para usar a ferramenta. Análise coletada por e hospedada no G2.com.

A ferramenta trava às vezes quando integrada com aplicativos poderosos e mesclada com o git. Como a ferramenta é pesada, ela utiliza o uso da CPU e memória, o que pode ser um problema de desempenho quando considerado como um todo. Análise coletada por e hospedada no G2.com.

As APIs Swagger são incrivelmente leves, e também têm uma implementação superior com menos alterações de código, caso sejam necessárias modificações no futuro. Uma coisa a notar é que o processamento OAuth carrega muito peso porque pode oferecer credenciais OAuth para toda a aplicação, bem como para solicitações individuais. Como usuário de API, tudo depende de quem mais precisa desse recurso. O framework swaggerHub torna a implementação de APIs muito fácil, e você pode testá-las rapidamente. Análise coletada por e hospedada no G2.com.

Nada encontra muito, mas alguma autorização deve ser incluída. Análise coletada por e hospedada no G2.com.

A flexibilidade e o uso que o SwaggerHub oferece em termos de uso e implementação de APIs e documentação são realmente inovadores. Em termos de criação de APIs usando diferentes frameworks, como Django, Laravel, NodeJs, e assim por diante, é necessário usar e testar consistentemente várias APIs para construir um sistema impecável, onde o SwaggerHub adiciona outra dimensão. Ao criar e testar APIs usando objetos JSON e de texto, podemos integrar o SwaggerHub conforme nossas necessidades com o sistema e o framework. Por exemplo, se quisermos criar uma API de postagem, podemos fornecer os parâmetros de consulta e diferentes cargas de dados conforme a necessidade da API. No entanto, podemos gerenciar, classificar e reter diferentes APIs de acordo com múltiplos projetos e aplicativos no SwaggerHub para facilitar o teste e a integração de APIs. Além disso, o processo de autenticação e autorização ao criar cabeçalhos e o fluxo de trabalho de login/logout pode ser facilmente gerenciado com apenas um clique usando o painel de login e adição de cabeçalhos do SwaggerHub. Além disso, posso adicionar objetos JSON e de texto personalizados conforme a carga útil da API e mostrar diferentes erros que podem quebrar o sistema durante os testes usando o SwaggerHub, o que é simplesmente um recurso excelente, na minha opinião. Análise coletada por e hospedada no G2.com.

A integração do SwaggerHub com o projeto à primeira vista é muito problemática e demorada, o que pode prejudicar a produtividade em termos de Desenvolvimento de Software. Por exemplo, integrar o SwaggerHub com um projeto Django requer a instalação de outros pacotes enquanto adiciona certas restrições e configurações no arquivo do projeto, o que é muito monótono e irritante. No entanto, para projetos grandes, o swagger leva um certo tempo para recarregar, o que prejudica a produtividade. Por exemplo, enquanto desenvolvemos continuamente um sistema, precisamos atualizar e recarregar regularmente a página do SwaggerHub para verificar atualizações, onde um recarregamento lento pode prejudicar o processo de desenvolvimento. Novamente, a cada recarregamento, o SwaggerHub perde os cabeçalhos carregados anteriormente na API, o que é também outra restrição. Análise coletada por e hospedada no G2.com.

Usamos o Swaggerhub em todo o nosso departamento de P&D, pois ele oferece um gerenciamento de API muito fácil de usar. Além disso, você pode compartilhá-lo facilmente com a equipe, o que torna a colaboração muito mais fácil. A melhor característica é o fato de que você pode testar suas APIs através dele, o que torna nosso trabalho muito mais fácil. Análise coletada por e hospedada no G2.com.

Eu não tenho grandes problemas com o Swaggerhub, talvez eu tenha uma melhoria para compartilhar, que é adicionar um recurso de download para a documentação em diferentes formatos. Análise coletada por e hospedada no G2.com.