Avaliações e Detalhes do Produto de Stoplight

- Um editor visual robusto para documentos OpenAPI

- Visualização instantânea das edições da especificação da API

- Capacidade de revisar internamente alterações não publicadas na especificação

- Colaboração em equipe

- Integração com Git

- Ferramentas de linting e mocking integradas

- Geração automática de documentação da API Análise coletada por e hospedada no G2.com.

- A interface do usuário é um pouco confusa, parece uma ferramenta construída por desenvolvedores. Embora tenha recebido algumas grandes melhorias recentemente

- Os documentos gerados poderiam ter navegação e descoberta mais fáceis

- Os documentos gerados não são responsivos (mas eles estão planejando resolver isso)

- A ligação cruzada entre artigos ou endpoints de API é um problema

- Não há controle suficiente sobre quais itens do documento OpenAPI aparecem na barra lateral de navegação e em que ordem

- Não há personalização suficiente ao incorporar os documentos do Stoplight em seu próprio site, mas eles estão planejando resolver isso na próxima versão Análise coletada por e hospedada no G2.com.

A interface de usuário simples torna a criação de mockups para endpoints de API e modelos de banco de dados muito fácil. Tendo migrado de outras plataformas que me obrigavam a desenvolver minhas especificações de API em formatos YAML/JSON, percebi que estava desperdiçando mais tempo descobrindo a estrutura para escrever mockups de API do que escrevendo os próprios mockups. Desde que comecei a usar o Stoplight, quase todo o meu tempo dedicado ao planejamento de arquitetura tem sido realmente gasto planejando a arquitetura, em vez de ter que validar meu esquema a cada poucos minutos.

A quantidade de detalhes que o Stoplight me permite fornecer para meus modelos e endpoints, tudo através de um editor de interface sem nunca precisar mudar para o código, é fantástica. O Stoplight também oferece a opção de editar o código que ele gera (seja no formato JSON ou YAML), embora eu raramente tenda a usar isso. Análise coletada por e hospedada no G2.com.

Não há nada sobre o Stoplight que eu desgoste, embora existam algumas irritações que tenho do meu tempo usando o serviço.

Eu geralmente forneço um exemplo de resposta de API para cada status HTTP que meus endpoints retornam. A maioria das respostas frequentemente inclui o uso de modelos do Stoplight (como retornar um modelo de usuário de um endpoint `GET /users/:id`), embora o Stoplight não atualize os exemplos se o modelo retornado no exemplo for modificado. Isso tem pouco impacto no meu projeto menor, embora eu possa imaginar projetos em grande escala enfrentando problemas onde modelos desatualizados são retornados como parte do exemplo.

Outro problema menor é a falta de opções de ordenação para esquemas. Embora eu entenda completamente que objetos JSON não têm realmente uma ordem, muitas vezes me vejo mudando para o editor de código apenas para mover campos de API nos meus esquemas para adicionar um pouco mais de lógica ao que o modelo representa. Por exemplo, eu costumo manter quaisquer campos de "metadados" (como um título, slug, etc.) no topo do esquema, e tudo o mais abaixo. Quando estou constantemente iterando sobre esses designs, as coisas frequentemente são movidas e separadas, o que pode fazer o modelo parecer mais complicado do que é. Análise coletada por e hospedada no G2.com.

Spotlight tem um recurso que possui uma ferramenta de preenchimento automático baseada em IA que torna a construção de novas APIs muito fácil, e se for baseada em outro modelo existente, é ainda mais simples. Análise coletada por e hospedada no G2.com.

Acho que, como a maioria das coisas, o custo sempre pode ser melhorado. Stoplight é capaz de apoiar empresas maiores, mas seu modelo de preços impede que ajudem as menores. Análise coletada por e hospedada no G2.com.

* Capacidade de gerenciar documentação como Código, em repositório Git, integração CI/CD e também capacidade de pré-visualizar e publicar.

* Stoplight é a única solução baseada em SaaS que permitiu manter o fluxo de trabalho mais próximo do fluxo de trabalho de desenvolvimento.

* Sua capacidade de permitir que usuários técnicos e não técnicos colaborem é incrível.

* Publicar API e documentação geral relativa entre si é maravilhoso. Análise coletada por e hospedada no G2.com.

* As imagens precisam ser publicamente acessíveis.

* Imagens em repositórios Git privados não são suportadas.

* Não é possível ter documentação vinculada a múltiplos "ambientes". Ela tem apenas visualizações de pré-publicação e publicação. Se permitisse uma maneira simples de vincular múltiplos ambientes à documentação correspondente e promovê-los juntos, teria sido mais incrível. Análise coletada por e hospedada no G2.com.

Este produto é fantástico. É uma ajuda robusta de monitoramento para o banco de dados. Não podemos verificar manualmente. É o melhor. Análise coletada por e hospedada no G2.com.

nada é desagradável, apenas uma coisa é que o modelo de precificação se tornou mais alto, então se um negócio menor não puder pagar por isso Análise coletada por e hospedada no G2.com.

Stoplight me permitiu começar a escrever a documentação da API imediatamente, sem qualquer complicação.

Em primeiro lugar, a interface era incrivelmente intuitiva, e era simples fazer coisas básicas como criar novos manuais de página e escrever a própria API. Quando fiz login pela primeira vez, bastaram alguns cliques para começar a escrever.

O layout padrão também era incrivelmente profissional, e para aqueles que são como eu, que não precisam de enfeites em termos de aparência e sensação da documentação, você acharia o Stoplight mais do que suficiente. Análise coletada por e hospedada no G2.com.

Um dos problemas com os documentos gerados é a falta de responsividade móvel da documentação gerada, mas isso já está no roteiro deles.

Não é um grande problema, pois documentos de API raramente são acessados pelo telefone, mas há consumidores potenciais que verificam a documentação usando seus telefones e isso pode ser uma causa de desestímulo. Análise coletada por e hospedada no G2.com.

Plataforma muito fácil de usar que está constantemente entregando novos recursos para ajudar com tudo relacionado a APIs. Ótimos blogs sobre melhores práticas e orientações sobre design e construção de APIs. Também gosto da capacidade de simulação embutida e do fato de que as respostas podem ser dinâmicas e até geradas usando o Faker para torná-las mais realistas. Análise coletada por e hospedada no G2.com.

Os custos de licenciamento podem ser bastante caros para equipes menores onde todos os membros precisam editar a especificação.

Os tempos de resposta do suporte podem ser um pouco lentos às vezes, especialmente para mim, já que estou na Austrália e eles estão do outro lado do mundo, o que significa que às vezes pode levar alguns dias para obter uma resposta às minhas consultas. Análise coletada por e hospedada no G2.com.

Tem uma interface refrescante; também usa versionamento no GitLab. É um recurso excelente. O modo escuro é incrível; parece mais limpo. Além disso, posso selecionar usar a estrutura JSON ou YAML. Estou animado sobre como essa ferramenta pode evoluir no futuro. Análise coletada por e hospedada no G2.com.

Você não pode exportar para JSON seus modelos ou estruturas criadas nas respostas personalizadas. Seria um recurso interessante exportar exemplos feitos com a interface em YAML ou JSON, algum botão ou opção na interface. Criar um novo branch para cada commit pode criar uma bagunça no Gitlab. O menu de navegação no painel apresentaria os Endpoints em uma pasta, não todos no mesmo nível. Análise coletada por e hospedada no G2.com.

Gostei de como é simples configurar a documentação da API com simulação e todos os recursos. É muito fácil de compartilhar e tem uma interface limpa e simples. Também adoro que todos os arquivos sejam armazenados como YAML no seu próprio repositório do GitHub, para que você possa migrar facilmente para qualquer outra ferramenta, se necessário. Análise coletada por e hospedada no G2.com.

Eu teria adorado ver mais controle sobre as configurações de compartilhamento de links. Talvez eu queira que seja privado ou visível apenas para algumas pessoas, etc. Além disso, o processo de integração do produto pode ser melhor. Na maior parte, eu tinha conhecimento sobre isso, então consegui resolver as coisas, mas, em geral, as pessoas podem precisar de alguma ajuda para começar. Análise coletada por e hospedada no G2.com.

A interface do usuário, referências a esquemas, servidor simulado, integração com GIT, plano gratuito para usar o serviço Análise coletada por e hospedada no G2.com.

A falta de operações em massa, problemas de desempenho ao abrir documentos, tempo de resposta a tickets relativamente lento Análise coletada por e hospedada no G2.com.