Stoplight Avantages et Inconvénients

Facile à créer plusieurs pages de documentation navigables - une page pour la référence API, une autre pour les articles de présentation et une autre pour n'importe quoi

L'interface de référence dispose d'un espace pour une explication générale, une explication de chaque paramètre et des exemples de code modifiables

La référence est maintenue en tant que document Open API Avis collecté par et hébergé sur G2.com.

La mise en forme du texte est limitée au markdown plus un peu plus

Impossible de redimensionner les images, vous devez les insérer à la taille finale

Vous devez passer à un abonnement de haut niveau pour les titres rétractables dans la navigation des articles (la référence a des titres rétractables) Avis collecté par et hébergé sur G2.com.

Créer des documents API via une interface graphique sans penser à écrire un fichier yaml. Avis collecté par et hébergé sur G2.com.

Je ne comprends pas les modèles, etc. J'ai besoin de formation. Avis collecté par et hébergé sur G2.com.

Interface utilisateur simple et éléments facilement configurables aident à la conception d'API. Avis collecté par et hébergé sur G2.com.

Ce devrait être un outil plus interactif et donner des options prédéfinies. Avis collecté par et hébergé sur G2.com.

La meilleure chose à propos de StopLight est qu'il prend en charge OpenAPI. Il nous permet également d'intégrer Git avec nos API. Il prend également en charge Markdown. Il nous permet également de partager nos API avec nos coéquipiers de manière pratique. Avis collecté par et hébergé sur G2.com.

C'est un peu plus difficile à configurer par rapport aux autres concurrents sur le marché. De plus, son interface utilisateur aurait pu être un peu plus conviviale. De plus, le support pour plusieurs environnements aurait pu être rendu un peu plus facile. Avis collecté par et hébergé sur G2.com.

* Interopérabilité avec d'autres environnements et outils de développement d'API REST

* Édition de formulaires graphiques des fichiers OAS

* Logiciel client Stoplight indépendant du système d'exploitation

* Options pour travailler en ligne ou hors ligne (dans un client Stoplight spécifique à l'OS)

* Rendu de documentation OAS beau et propre sous forme d'arborescence Avis collecté par et hébergé sur G2.com.

Rare bogue d'affichage du formulaire de documentation OAS (rencontré uniquement dans une version en ligne), empêchant les types de données de tableau de s'afficher correctement. Avis collecté par et hébergé sur G2.com.

La capacité de tester les API en ligne pour les environnements de test et de production sans réellement télécharger d'autres outils comme Postman par exemple. Avis collecté par et hébergé sur G2.com.

Capacité à générer un document PDF pour que quiconque puisse se référer hors ligne aux API. Avis collecté par et hébergé sur G2.com.

Stoplight est assez facile à utiliser et même les utilisateurs non techniques peuvent commencer rapidement. Il sert à plusieurs cas d'utilisation comme la conception d'API, le développement d'API, la simulation d'API, la documentation d'API, et même la documentation générale et les guides. Il vous aide également à mettre en place des processus et des vérifications de qualité logicielle et API via le linting. C'est un bon concurrent de Postman, qui cherche également à conquérir le marché de la pile API complète - développement, documentation et distribution. La façon dont l'équipe travaille et pense à de nouvelles fonctionnalités est admirable. Avis collecté par et hébergé sur G2.com.

Le soutien pourrait être meilleur. Il y a beaucoup d'éléments de retour d'information sur leur feuille de route publique qu'ils devraient absolument aborder et avoir plus de personnes techniques du côté du support. Avis collecté par et hébergé sur G2.com.

- C'est simple à utiliser.

- L'un des meilleurs outils sur le marché.

- L'équipe est très solidaire et répond rapidement aux questions.

- L'intégration Git est la meilleure fonctionnalité. Avis collecté par et hébergé sur G2.com.

Je n'ai vraiment rien à détester, mais en tant que demande de fonctionnalité, ce serait bien d'avoir la possibilité d'héberger également la documentation de l'API GraphQL via Stoplight. Avis collecté par et hébergé sur G2.com.

Stoplight cartographie automatiquement et sans effort une API, puis présente des services et des outils pour réduire le temps de développement et améliorer l'accessibilité et la fiabilité. Rend les utilisateurs d'API plus productifs. J'aime comment la boîte à outils de spécification OpenAPI nous permet de produire une spécification OpenAPI sans avoir besoin de connaissances techniques préalables. J'aime la facilité avec laquelle on peut fusionner des fichiers OpenAPI avec Markdown pour produire une documentation attrayante pour les parties prenantes externes et internes. J'ai pu utiliser la spécification OpenAPI avec l'éditeur visuel des logiciels, ce qui m'aide à créer des API REST standardisées et cohérentes pour mon organisation. Avis collecté par et hébergé sur G2.com.

Sans codage, je suis capable de concevoir des API complexes rapidement. J'apprécie le bon travail effectué par l'équipe de support qui est dédiée et proactive 24/7. Avis collecté par et hébergé sur G2.com.

Les serveurs de simulation sont très pratiques. Ici, les équipes frontend et backend peuvent travailler en parallèle et avoir un aperçu de ce à quoi l'application à développer ressemblera.

Le développement en parallèle est un autre atout de cette plateforme. Les outils pour créer de la documentation pour les programmes que nous développons sont parfaits. La référence de modèle est l'une des meilleures fonctionnalités pour la collaboration. En général, le logiciel a une interface utilisateur qui facilite tout ce qui est lié au développement d'applications. Avis collecté par et hébergé sur G2.com.

Malgré toutes les installations que Stoplight offre, le prix est élevé. Même les utilisateurs sans autorisations d'édition doivent payer pour voir le développement. Avis collecté par et hébergé sur G2.com.