Stoplight Avantages et Inconvénients

Nous avons choisi Stoplight pour le générateur de code multilingue. Les développeurs l'adorent. Avis collecté par et hébergé sur G2.com.

Pas de problèmes majeurs. OpenAPI est compliqué et Stoplight fait un bon travail pour le rendre facile à utiliser. Avis collecté par et hébergé sur G2.com.

L'éditeur de schéma avec références de modèle est un outil très utile pour construire et modifier rapidement les définitions de chemin. Il est également possible de partager une documentation publique basée sur le schéma. Avis collecté par et hébergé sur G2.com.

Pas de support pour OAS 3. Aucune possibilité d'ajouter des règles de lint personnalisées. Avis collecté par et hébergé sur G2.com.

Les éditeurs de schéma JSON, les importations et l'éditeur de tutoriels avec des exemples interactifs. Avis collecté par et hébergé sur G2.com.

Manque de support GraphQL (aire de jeu dans les exemples, à ma connaissance). Manque d'un moyen facile de documenter plusieurs API avec différents niveaux d'accès et de partager des ressources et des schémas. Avis collecté par et hébergé sur G2.com.

Stoplight a mis une interface utilisateur incroyable au-dessus de la documentation API. Leurs outils sont rapides, faciles à utiliser et vraiment bien faits. De plus, vous avez toujours accès à la visualisation des données Swagger qui alimentent l'application, ce qui est vraiment utile pour les utilisateurs plus techniques. Avis collecté par et hébergé sur G2.com.

C'était difficile pour notre équipe de maintenir cela à jour. Une intégration plus rationalisée avec AWS API Gateway aurait été formidable (et peut-être existe-t-elle maintenant, je n'ai pas vérifié). Avis collecté par et hébergé sur G2.com.

L'interface graphique est excellente et le fait qu'elle prenne en charge les normes Open-API me rend confiant que nous pouvons construire nos outils autour d'elle. Avis collecté par et hébergé sur G2.com.

L'équipe du feu de signalisation m'a assuré que cela sera corrigé dans la prochaine version -- L'outil a une approche centrée sur l'hébergement en ligne, ce qui a rendu difficile son intégration dans notre base de code multi-branches où de nouvelles fonctionnalités sont développées sur différentes branches. Avis collecté par et hébergé sur G2.com.

La capacité d'ajouter et de manipuler rapidement des éléments avec le concepteur, mais tout en ayant la possibilité de faire des modifications directement sur les données JSON. De plus, la capacité de travailler avec tous les projets via git rend possible de sortir des sentiers battus. Avis collecté par et hébergé sur G2.com.

Je voudrais pouvoir utiliser l'édition YAML, avoir la capacité de segmenter les versions de sorte que, par exemple, la v1.1 soit publiée, mais que ceux ayant une autorisation suffisante puissent accéder à la v1.2 en développement.

De plus, la gestion des versions devrait être en semver complet, afin que je puisse avoir 1.1.1 et 1.1.2, et pas seulement 1.11 et 1.12. Avis collecté par et hébergé sur G2.com.

La personnalisation du test de contrat API et l'ajout de tests supplémentaires est excellente. Pouvoir personnaliser le test via JavaScript est un avantage. Avis collecté par et hébergé sur G2.com.

Le Stoplight Next application de bureau présente des bugs lorsqu'il tente d'ouvrir une nouvelle fenêtre. Avis collecté par et hébergé sur G2.com.

Facile à générer et structurer votre documentation API. Également prise en charge de l'hébergement de plusieurs API avec des modèles et des informations partagés. Avis collecté par et hébergé sur G2.com.

Le journal d'audit est inutile pour découvrir les modifications apportées au document par d'autres personnes. Nous cherchions un outil pour gérer et surveiller l'API, mais Stoplight ne pouvait pas répondre à nos besoins ici. Avis collecté par et hébergé sur G2.com.

C'est un outil très utile pour l'utilisateur non technique (côté affaires) pour formuler et structurer l'API avant qu'elle ne soit mise en œuvre.

Je peux documenter le contexte commercial avec la structure technique de l'API et générer une documentation API facile à utiliser à partir de celle-ci. Avis collecté par et hébergé sur G2.com.

Il n'y a aucun moyen de partager un brouillon de documentation API uniquement avec un public limité. Le prix de l'hébergement de la documentation n'est pas raisonnable pour les petites équipes si elle est utilisée uniquement pour s'accorder sur la structure de l'API. Et le module de conception Stoplight nécessite une certaine expérience avant de pouvoir examiner l'API proposée. Avis collecté par et hébergé sur G2.com.

Conception intuitive d'API outil GUI

Très bon support

Très rentable Avis collecté par et hébergé sur G2.com.

Lorsque plusieurs personnes travaillent sur la conception d'une API, il n'y a pas beaucoup d'informations sur qui a changé quoi. Plus de travail est nécessaire dans ce domaine. Avis collecté par et hébergé sur G2.com.