Avaliações e Detalhes do Produto de Stoplight

A organização dos endpoints e modelos, assim como a documentação online. Análise coletada por e hospedada no G2.com.

Às vezes, fico confuso tentando encontrar um modelo que salvei por engano em objetos compartilhados. Poderia haver uma mensagem de confirmação antes desse tipo de ação (algo como: você realmente quer compartilhar este modelo?) Análise coletada por e hospedada no G2.com.

Os recursos colaborativos de design de API OAS do Stoplight têm sido extremamente valiosos para incentivar nossa equipe a abordar deficiências de API em vários de nossos serviços. Podem ser formadas equipes e atribuídas a APIs específicas que estão sendo desenvolvidas para a organização. A própria ferramenta permitiu que nossas equipes abordassem APIs ausentes ou deficientes para vários serviços, e o fizessem de maneira compatível com OAS. Na maioria dos casos, os serviços já existiam, mas não tinham API (ou tinham uma API limitada). O Stoplight promoveu a rápida integração de desenvolvedores com poucas horas de trabalho e o subsequente design de API para resolver as deficiências. No caso de um serviço recém-adicionado, o Stoplight permitiu que a equipe adotasse uma abordagem de API-first, o que até então era raro para nós e provavelmente não teria acontecido—ou não com clareza e formalismo suficientes—sem o Stoplight. Nosso grupo é pequeno, com desenvolvedores geralmente responsáveis pela maioria das fases do desenvolvimento de software de seus projetos atribuídos e poucos processos formais. A incorporação do Stoplight nos processos de desenvolvimento existentes foi recebida de forma muito positiva e não trouxe altos custos de integração ou de oportunidade, o que era um requisito chave vital. O uso do Stoplight colocou maior ênfase no design de API antes da implementação, permitindo que fosse melhor planejado, em alguns casos revisado, contribuído por outros membros da equipe, e implementado um pouco mais rápido e com maior alcance do que teria sido alcançado de outra forma. Análise coletada por e hospedada no G2.com.

Como alguns outros, nós também fomos integrados a uma versão beta do Stoplight Next, o que causou alguns problemas inicialmente. No entanto, como isso coincidiu com a necessidade dos membros da equipe de preencher lacunas de conhecimento em relação ao OAS, o efeito desses problemas foi menor. Atualmente, estamos tendo mais problemas com a publicação da documentação (e especificação OAS, disponível via API) e a apresentação da documentação de uma maneira agradável. Isso também pode refletir nossa falta de familiaridade com as capacidades, ou pode refletir restrições na produção de documentação do Stoplight; ainda não temos certeza. Além disso, temos necessidade de documentação de API não-OAS, embora isso possa estar fora do escopo do Stoplight. Análise coletada por e hospedada no G2.com.

Após avaliar vários produtos para documentar múltiplas APIs REST - Postman, Swagger, API Blueprint e o principal diferencial para mim foram:

- a capacidade de misturar documentação no estilo OAS e páginas em Markdown, oferecendo uma ferramenta única para escrever toda a documentação da API.

- um editor agradável para o documento OAS, que oferece tanto uma interface de usuário quanto uma maneira de editar dados JSON diretamente.

A equipe foi muito responsiva às perguntas durante o teste e após se tornar um cliente pagante. Eles também têm sido abertos às minhas solicitações de recursos.

A nova versão (Next) evoluiu bem desde seu lançamento há alguns meses. Análise coletada por e hospedada no G2.com.

Eu comecei a usar o StopLight quando o Next estava em beta. Tive alguns problemas menores, mas a equipe foi responsiva em resolvê-los e não encontrei problemas por semanas. Análise coletada por e hospedada no G2.com.

A capacidade de contribuir com várias pessoas para a mesma especificação. Que é traduzido para oas nos bastidores. A facilidade de definir modelos e testes na ferramenta. Publicar automaticamente a documentação em html... Análise coletada por e hospedada no G2.com.

O mesmo usuário em várias organizações é cobrado em cada organização. Dentro da nossa empresa, usamos o stoplight para todos os nossos clientes, mas quando o cliente quer contribuir, precisamos criar um projeto em uma organização separada (dessa forma, o cliente não pode ver os outros projetos de outros clientes). A desvantagem é que cada usuário do nosso lado é cobrado por cada organização. Análise coletada por e hospedada no G2.com.

Eu adoro como o Stoplight é acessível para todos em nossa organização. Tornou-se uma ferramenta essencial para planejar e organizar nossa API - uma ferramenta que até mesmo pessoas não técnicas entendem e compreendem.

Eu também adoro a documentação hospedada - é rápida e estável. Análise coletada por e hospedada no G2.com.

Eu entro no Stoplight realmente acostumado com a especificação OpenAPI (swagger). Às vezes, é realmente difícil descobrir como fazer algo no Stoplight que eu já sei como fazer na especificação OpenAPI. Análise coletada por e hospedada no G2.com.

As a Technical writer I need a friendly tool, with an easy-to-use interface so I can better collaborate with the development teams in the development and review of the documentation of our APIs. Its integration with Git allows teams to collaborative in a coordinated way. Análise coletada por e hospedada no G2.com.

Stoplight seems to be an immature tool yet, so now and them I stumble upon errors, or I miss things that I think should be there already. For example, I’ve noticed than when had unsaved changes, Stoplight wouldn’t make me aware of that, and then I’d lose my work (This is fixed now). Análise coletada por e hospedada no G2.com.

Projetar uma API é extremamente intuitivo e simples. O teste simulado é fácil de configurar. Estamos permitindo o desenvolvimento simultâneo de front-end e back-end para um contrato acordado definido no Stoplight. Análise coletada por e hospedada no G2.com.

Gestão de modelos comuns e respostas entre projetos. Em um mundo de microsserviços, estamos definindo muitos projetos de semáforo, no entanto, há elementos comuns que gostaríamos de compartilhar entre esses projetos. Tornar isso mais fluido seria uma grande economia de tempo. Análise coletada por e hospedada no G2.com.

A simplicidade ao compartilhar especificações de API com colegas de trabalho e permitir que todos os usuários alterem essas especificações. A documentação gerada é outra característica positiva. Finalmente, o fato de ainda podermos editar diretamente a especificação do código em alguns casos em que podemos simplesmente copiar de outro local. Análise coletada por e hospedada no G2.com.

Difícil de usar versionamento. Um recurso incrível seria o histórico de alterações, mesmo que apenas localmente. Análise coletada por e hospedada no G2.com.

Organização da UI, simulação, uso pronto, etc. Análise coletada por e hospedada no G2.com.

Versionamento/commits é estranho/esquisito. Não há documentação disponível. Não há uma maneira clara de ter branches atuais vs WIP de design de API. Dei uma olhada no Stoplight Next e fiquei animado com as coisas que apareceram lá, mas não consegui encontrar documentação facilmente, então ficamos com medo de dar o salto. Análise coletada por e hospedada no G2.com.

Stoplight tem uma interface excelente para design de API, documentação e, em seguida, geração automática de uma especificação swagger. O serviço é ótimo e a equipe é receptiva ao feedback. Análise coletada por e hospedada no G2.com.

Estamos em uma versão mais antiga do Stoplight e ainda não mudamos para a nova versão. Análise coletada por e hospedada no G2.com.