Prós e Contras de Stoplight

Configuração fácil, integrações úteis e alterações rastreáveis. Análise coletada por e hospedada no G2.com.

Nada em particular; talvez os preços sejam relativamente altos. Análise coletada por e hospedada no G2.com.

Eu adoro que seja fácil de usar e a interface é muito suave, podemos personalizar a aparência e a documentação como quisermos. Eu gosto que também suporte diferentes linguagens como Java, Python e JavaScript para gerar os arquivos do servidor. Oferece recursos extensivos de confiabilidade e polimorfismo ao trabalhar com nossa introspecção de usuário e modelos de arquivos seguros. Também inclui expressões-chave que ajudam na avaliação em tempo de execução e identificam a URL a ser usada para nossa solicitação de callback. A documentação da API de Automação para todos os serviços é muito útil para que clientes e desenvolvedores entendam e realizem tarefas rapidamente. Análise coletada por e hospedada no G2.com.

Requer uma quantidade imensa de trabalho se forem necessárias alterações no fluxo de trabalho existente. É capaz de gerar os documentos, mas um novo recurso para converter esses documentos em páginas wiki pode adicionar mais valor a este produto. Cada retorno de código para a estrutura de definição deve seguir uma sintaxe rigorosa, caso contrário, é difícil rastrear erros. 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.

Simplicidade - trabalhando com arquivos markdown, gerando automaticamente trechos de código/exemplos para APIs Análise coletada por e hospedada no G2.com.

Manipulação de links dinâmicos, falta de funcionalidade para criar links permanentes.

Estrutura (hierarquia) entre projetos, pastas, arquivos, grupos, etc. não está clara. Análise coletada por e hospedada no G2.com.

Quão fácil é a reutilização disso. Adoramos criar rapidamente designs, compartilhar, validar e mudar em escala. Análise coletada por e hospedada no G2.com.

É difícil no início, uma interface mais complexa e poderíamos ter usado alguns guias de introdução e documentação mais clara. Análise coletada por e hospedada no G2.com.

É uma plataforma de software de código aberto que qualquer pessoa ou empresa pode usar gratuitamente. Gosto que tenha uma maneira muito fácil de compartilhar documentos relacionados a API sem qualquer intervenção manual, basta fazer a codificação e o documento será buscado automaticamente. Fornece API segura ao suportar autenticação baseada em token, então não é exposta ao mundo exterior. Ajuda com a documentação automática de API e é bastante plugável ao testar as APIs restantes. Adoro que facilita o compartilhamento ou uso conjunto para projetos colaborativos para a equipe e dentro do grupo. Partes semelhantes da API são tratadas inteiramente pela equipe de back-end. Análise coletada por e hospedada no G2.com.

Ao atualizar ou criar novas entradas de API, não é muito fácil manter a indentação e isso levou mais tempo do que o esperado. Eu vi que parte da documentação da API também contém caracteres indesejados. Criar documentação de API do zero não é muito amigável para iniciantes. O teste dos endpoints da API também está ausente. Deve permitir que você defina configurações de variáveis de ambiente para que, quando houver uma mudança nos detalhes do servidor de implantação, apenas os detalhes das variáveis sejam alterados. Análise coletada por e hospedada no G2.com.

Simples de usar, compartilhar e oferece uma ótima visão geral dos seus serviços. Análise coletada por e hospedada no G2.com.

Eu gostaria de ver o recurso de pull request melhorado significativamente, para que eu possa raciocinar melhor com meus colegas de trabalho sobre uma mudança. Análise coletada por e hospedada no G2.com.

Adoro ter meus pedidos organizados por projeto. É bastante rico em recursos com ambientes e variáveis, o que torna bastante fácil testar e ver como as APIs se comportam. Além disso, a interface do usuário da ferramenta é muito boa. Também podemos criar uma coleção de APIs e podemos facilmente baixá-las em nosso sistema. A capacidade de escrever scripts de teste é um recurso muito gratificante. Também gosto que o melhor recurso do Postman seja criar um ambiente de trabalho online e compartilhá-lo com sua equipe. Gosto de como ele salva seus pedidos anteriores na barra superior, como um navegador de internet faz. Análise coletada por e hospedada no G2.com.

Acho que seria bom ver mais codificação por cores porque facilita a detecção de variáveis, entradas, valores de entrada. Não há nada que eu não goste no produto. Análise coletada por e hospedada no G2.com.

Stoplight torna fácil projetar APIs com sua interface de usuário fácil de entender, integração com várias plataformas de controle de versão e suporte para bibliotecas compartilhadas e desenvolvimento em equipe. Análise coletada por e hospedada no G2.com.

Usar o Stoplight como portal de documentação pública ainda não está totalmente lá. Não é tão maduro nesse aspecto quanto outras plataformas. Análise coletada por e hospedada no G2.com.

Stoplight é um serviço hospedado, então não preciso me preocupar em hospedar minha documentação de API.

A Definição de API e a documentação sincronizam com o Github, então podemos manter o histórico e rastrear mudanças em nossas ferramentas internas.

No geral, o preço que pagamos por mês é muito menor do que nos custaria construir e manter o produto. Análise coletada por e hospedada no G2.com.

A interface web que eles oferecem é um pouco limitada. Embora eu prefira não ir até o fim e desenvolver um aplicativo React com seu kit de ferramentas, ainda quero controlar a personalização. Eles às vezes têm períodos de inatividade e erros de renderização (o que significa que as páginas de documentação não são estáticas, como deveriam ser). Mesmo para clientes pagantes, o suporte responde dentro de algumas horas a um dia útil (acho que no horário de trabalho dos EUA). Análise coletada por e hospedada no G2.com.

Eu gosto que seja amigável ao usuário e nos permita trabalhar com nossos clientes ao lado de chamadas de API de teste. Análise coletada por e hospedada no G2.com.

Eu gostaria que permitisse mais personalização e também fornecesse mais tutoriais para autoatendimento. Análise coletada por e hospedada no G2.com.