Stoplight Avantages et Inconvénients

Les API peuvent être créées directement sur le web en partageant simplement une URL, de nombreux autres logiciels de création d'API ne le permettent pas. Il détecte également automatiquement les problèmes qui peuvent persister lors de la création. Avis collecté par et hébergé sur G2.com.

Le schéma corporel n'est pas validé par rapport aux images corporelles, ce qui est un inconvénient pour ce logiciel. À part cela, l'interface utilisateur du logiciel dans la version de bureau est un peu complexe et prend donc du temps à configurer. Avis collecté par et hébergé sur G2.com.

La conception de l'interface utilisateur est vraiment agréable ; l'expérience utilisateur ne pourrait pas être meilleure. Avis collecté par et hébergé sur G2.com.

J'aimerais une meilleure méthode d'exportation du json. Avis collecté par et hébergé sur G2.com.

Cette plateforme est si équilibrée qu'elle offre aux développeurs une expérience développeur (vue Code et Design) et une vue Lecture et Design pour le personnel non technique. Avis collecté par et hébergé sur G2.com.

La courbe d'apprentissage a été considérablement réduite grâce à la formation offerte par l'équipe Stoplight et à la documentation précieuse. Avis collecté par et hébergé sur G2.com.

Stoplight offre une excellente solution à la fois pour rédiger la documentation API ainsi que pour la publier et la partager. L'éditeur OpenAPI dans Stoplight Studio est bien en avance sur tout ce que nous avons essayé. Et le support des fichiers Markdown est une excellente fonctionnalité complémentaire pour rédiger des guides étape par étape pour des cas d'utilisation spécifiques.

La documentation publiée est excellente et facile à parcourir. Nous recevons continuellement des retours des intégrateurs qui adorent l'apparence et la convivialité de nos documents API.

Nous apprécions également la possibilité de créer plusieurs projets dans Stoplight pour documenter toutes nos API en un seul endroit. C'est quelque chose que d'autres solutions manquent souvent, car elles se concentrent sur la fourniture d'une interface de documentation pour une seule API.

Le support technique de Stoplight est également excellent, prenant même le temps de mettre en place un appel pour des questions plus complexes si nécessaire. Avis collecté par et hébergé sur G2.com.

Bien que l'éditeur et les documents publiés soient tous deux excellents dans l'ensemble, il y a encore quelques petites contrariétés que nous avons avec le produit. Cela va de petits bugs comme les opérations API étant triées de manière aléatoire dans les documents publiés (au lieu d'être triées de la même manière que spécifiée dans le fichier OpenAPI) à des fonctionnalités (mineures) manquantes telles que le support des schémas conditionnels dans l'éditeur OpenAPI. Cependant, nous sommes convaincus qu'avec le temps, tout cela sera peaufiné par l'équipe de Stoplight alors que nous constatons des améliorations continues de la plateforme. Avis collecté par et hébergé sur G2.com.

Stoplight fournit une interface très simple pour documenter vos API, et vous pouvez également les séparer entre celles internes et externes, de sorte que seule votre équipe ait accès aux éléments internes. Avis collecté par et hébergé sur G2.com.

Le long moment que j'ai pris pour découvrir Stoplight :) Avis collecté par et hébergé sur G2.com.

Bel aspect et sensation. Interface utilisateur logique. Pas seulement pour publier YAML mais aussi pour créer des pages de contexte. Le support client existe, mais est d'une aide limitée. Avis collecté par et hébergé sur G2.com.

L'une des méthodes recommandées de travail - diviser le document OpenAPI en plusieurs fichiers - ne fonctionne pas correctement. Tous les attributs de la classe enfant sont écrasés par la classe parente, détruisant les descriptions et validations de l'enfant, ce qui est inacceptable. Il y a d'autres problèmes qui ne propagent pas correctement les commentaires à l'interface utilisateur.

Mauvais rapport qualité-prix, coûteux.

Mauvais support de la protection par mot de passe des documents pour un public limité. L'enregistrement ne fonctionne pas bien. Avis collecté par et hébergé sur G2.com.

J'aime la facilité de l'automatisation.

Connexion facile avec GitHub ACC

C'est un logiciel facile à comprendre

Tester l'API est facile Avis collecté par et hébergé sur G2.com.

Nous avons utilisé ce produit dans quelques projets et jusqu'à présent tout va bien. Avis collecté par et hébergé sur G2.com.

La facilité de créer de nouveaux documents (docs OpenAPI, guides et articles) suivant un thème cohérent.

La publication immédiate lorsque les documents sont prêts.

La possibilité d'appliquer un contrôle de version aux documents grâce à l'intégration de git. Avis collecté par et hébergé sur G2.com.

Formulaires intégrés (c'est-à-dire, la possibilité de créer un formulaire et de recevoir les données remplies soit sur une page du tableau de bord Stoplight, soit par email)

Éléments multimédias supplémentaires (vidéos intégrées, fichiers audio). Avis collecté par et hébergé sur G2.com.

La capacité d'avoir tous nos documents API dans un emplacement central est incroyable. Stoplight studio est également un outil incroyable qui supprime le besoin de connaître la spécification openAPI. Avis collecté par et hébergé sur G2.com.

Il n'y a pas grand-chose à ne pas aimer honnêtement. Je suppose que le coût est un peu élevé, mais c'est un excellent outil destiné aux entreprises, donc même cela n'est pas vraiment un gros problème. Avis collecté par et hébergé sur G2.com.

Easy to use, well structured and intuitive user interface with all necessary functionalities. Avis collecté par et hébergé sur G2.com.

Downsides include the lack of support for multiple languages like Python Avis collecté par et hébergé sur G2.com.