Avaliações e Detalhes do Produto de SwaggerHub

A interface do usuário é simples e limpa, proporciona facilidade de acesso para novos usuários. O token de autenticação pode ser configurado facilmente. Eu o uso em minhas atividades diárias de desenvolvimento. As APIs que escrevi, eu as testo usando o swagger. Depois de testar minhas APIs através do swagger, então começo a integração com as APIs do frontend. Com alguma configuração adicional, o swagger mantém o token de autenticação, altera o tema e exibe o tempo de resposta também. Análise coletada por e hospedada no G2.com.

Se recarregarmos o swagger, todo o corpo de solicitação que fizemos anteriormente para as APIs será apagado, deveríamos ter uma opção de persistência para salvar solicitações. Por exemplo, o postman suporta salvar solicitações etc. A opção de filtro do Swagger não está à altura. Análise coletada por e hospedada no G2.com.

Gosto disso porque posso trabalhar com outros colegas de equipe desenvolvendo nossa documentação no mesmo projeto, gosto disso porque podemos ter nossos próprios ramos para desenvolvimento, podemos pesquisar dependendo da frequência de atualização ou pesquisar por nome, é muito útil quando o projeto se torna muito grande e quando trabalhamos com muitas pessoas. Análise coletada por e hospedada no G2.com.

Eu não gosto que não possamos ver de uma maneira fácil quais mudanças nossos colegas de equipe fazem no documento do swaggerHub, esse processo precisa ser feito manualmente. Análise coletada por e hospedada no G2.com.

Eu uso o SwaggerHub frequentemente para criar documentação de API.

Fácil testar as APIs localmente antes das implantações.

Simples exportar o código para a linguagem de programação de minha escolha e a implementação é facilitada.

Capaz de testar a segurança da API com autenticação OAuth.

Fácil validar solicitações de API e integrar a outros sistemas.

Fácil copiar/baixar solicitações curl. Análise coletada por e hospedada no G2.com.

A versão gratuita tem recursos limitados.

Assim que atualizarmos o swagger, a carga útil json será redefinida para o padrão e os parâmetros de consulta serão apagados.

As opções de colaboração em equipe são limitadas. Análise coletada por e hospedada no G2.com.

Sua documentação estruturada ajuda muito ao fazer qualquer integração. Análise coletada por e hospedada no G2.com.

Sua autorização, às vezes, fica com falhas e precisa ser reautorizada. Análise coletada por e hospedada no G2.com.

Eu gosto que seja acessível e me ajude a depurar mais rapidamente. Análise coletada por e hospedada no G2.com.

A interface do usuário não é tão boa. Eu gostaria que fosse mais amigável. Análise coletada por e hospedada no G2.com.

Ele ajuda a entender o esquema e os pontos de dados, o que nos ajuda a integrar serviços de forma contínua. Análise coletada por e hospedada no G2.com.

Seria ótimo se isso nos ajudasse com descrições de cada campo e se é um campo anulável ou não. Análise coletada por e hospedada no G2.com.

A principal vantagem é a geração automática de SDKs de cliente e servidor em várias linguagens, que acelera o processo de desenvolvimento. Análise coletada por e hospedada no G2.com.

Eu não encontrei nenhuma preocupação ao usar o Swagger Hub. Análise coletada por e hospedada no G2.com.

Easy to use and document various API routes and models. Can fast track API documentation. Análise coletada por e hospedada no G2.com.

Interface is clunky, requires a lot of clicks to send a simple request. Models are poorly formatted and hard to read. Lack of support for things like recursive models. Análise coletada por e hospedada no G2.com.

O SwaggerHub fornece ferramentas robustas para projetar suas APIs com documentação adequada e exemplos. Você pode criar um novo documento vazio, escolher entre uma tonelada de modelos relacionados ou importar um projeto existente. Algumas das características que eu gosto no Swagger são:

* Saída instantânea: Você pode ver instantaneamente a saída atual do script a qualquer momento.

* Flexível: Você também pode editar visualmente o documento de saída além do código.

* Geração de base de código: Você pode gerar um grande volume de código e adicioná-lo à sua API.

* Exemplos: Você pode adicionar exemplos para execuções bem-sucedidas ou erros.

* Colaboração: Você pode colaborar com membros da sua equipe e membros de outras equipes também. Análise coletada por e hospedada no G2.com.

Algumas desvantagens do SwaggerHub são:

* Falta de integração: Embora o SwaggerHub ofereça conectores para integração, ele não possui integração suficiente para cobrir todas as APIs, como SVN ou Jira. Análise coletada por e hospedada no G2.com.

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.