Prós e Contras de Stoplight

As regras espectrais são realmente ótimas e me ajudam a manter meus arquivos OpenAPI limpos, e a seção de Propostas é realmente útil para a compatibilidade de versões. Análise coletada por e hospedada no G2.com.

Acho o acesso baseado em funções confuso e um pouco difícil de gerenciar. Convidar um convidado para o meu projeto de API tem etapas demais. Análise coletada por e hospedada no G2.com.

A interface do usuário para a versão desktop é excelente, e o suporte para GIT torna a colaboração fácil. Análise coletada por e hospedada no G2.com.

Encontrei alguns bugs na interface web, que foram muito frustrantes. Estes não estavam presentes na versão para desktop. Análise coletada por e hospedada no G2.com.

Mock testing permite o desenvolvimento baseado em contratos Análise coletada por e hospedada no G2.com.

Navegação estranha para a página inicial e editor de texto básico Análise coletada por e hospedada no G2.com.

Eu aprecio como a interface do usuário é simples de operar e como o design e a sensação são simples, e a documentação pode ser modificada. É realmente ótimo que seja capaz de construir arquivos de servidor em diferentes linguagens, como Java, Python e JavaScript. Ele se integra usando nossa introspecção de usuário e modelos de arquivos seguros, enquanto oferece uma ampla gama de recursos de confiabilidade e polimorfismo. Além disso, contém as expressões-chave que auxiliam na avaliação em tempo de execução e nos ajudam a escolher a URL a ser usada para nossa solicitação de callback. Aqui podemos revisar e publicar designs de API. Análise coletada por e hospedada no G2.com.

Para competir com outros produtos de software de verificação de API, eles devem fornecer mais capacidades. Se houver ajustes que precisam ser feitos no fluxo de trabalho atual, isso exigirá uma quantidade tremenda de trabalho. Embora possa produzir documentos, uma nova função que transforme esses documentos em páginas wiki pode tornar o produto ainda mais valioso. Uma sintaxe rigorosa deve ser seguida por cada retorno de código para a estrutura de definição; caso contrário, as falhas são difíceis de rastrear. Análise coletada por e hospedada no G2.com.

Projete, codifique e teste com conhecimento mínimo das especificações OpenAPI. Defina modelos genéricos, encontre-os e use-os onde se encaixarem melhor. Integração com várias ferramentas de controle de código. Análise coletada por e hospedada no G2.com.

Adição de tags x-stoplight. Incapacidade de refatorar quando o Modelo é alterado, e está sendo referido em outras especificações. A experiência de encontrar e alterar o código yaml não é boa. Análise coletada por e hospedada no G2.com.

Capacidade de usar GUI para documentar endpoints. Fácil de usar, fácil de identificar um problema. Análise coletada por e hospedada no G2.com.

Eu não tenho algo para reclamar. Análise coletada por e hospedada no G2.com.

Muito fácil documentar APIs sem conhecimento amplo do padrão OpenAPI. O que selou o acordo para mim foi: 1. a capacidade de obter um mockup de um esquema de corpo de solicitação/resposta de API a partir de conteúdo JSON; 2. os exemplos de resposta de API gerados dinamicamente. A documentação da API é bastante organizada e clara. Análise coletada por e hospedada no G2.com.

Alguns recursos básicos da especificação OpenAPI, como variáveis de servidor, ainda precisam ser suportados. Eu entendo que é de certa forma um produto "jovem" (2019), mas às vezes sinto que algo ainda pode precisar de algum refinamento/polimento. Análise coletada por e hospedada no G2.com.

Stoplight é uma ferramenta muito poderosa que me permite criar documentação para uma API. Posso então compartilhar essa documentação com meus clientes para que eles possam desenvolver suas ferramentas. Análise coletada por e hospedada no G2.com.

O grande número de opções torna a interface um pouco complicada e requer algum tempo para aprender. Análise coletada por e hospedada no G2.com.

É fácil de usar e explicar para os outros. Também é fácil colaborar e integrá-lo com nosso VCS. Análise coletada por e hospedada no G2.com.

Seria ótimo se você pudesse criar mais facilmente também uma documentação que não segue o padrão OpenAPI, por exemplo, uma documentação JSON RPC. É um pouco difícil fornecer os endpoints corretos ou fornecer exemplos. Análise coletada por e hospedada no G2.com.

- Muito simples de usar flags de recursos semelhantes a binários

- Acho muito útil que a variável, uma vez criada, esteja disponível em todos os ambientes

- API realmente fácil

- Também integramos ao Slack, então é legal receber mensagens quando o status de uma flag muda, para que estejamos cientes se algum colega muda algo que possa nos impactar

Estou animado para um dia usar os recursos mais complexos, como flags de recursos aninhados, não binários, distribuição de valores com base em algumas regras de segmentação, etc. Análise coletada por e hospedada no G2.com.

- Achei um pouco confuso e redundante a necessidade de gerenciar, para bandeiras simples do tipo binário, o direcionamento (ligado/desligado), a regra padrão (ligado/desligado) e, se o direcionamento estiver desligado, o que servir (ligado/desligado). Análise coletada por e hospedada no G2.com.