Stoplight Avantages et Inconvénients

Il satisfait mon exigence pour une documentation interactive basée sur des documents Markdown et OpenApi. La génération de fragments de code client, le linter API et les fonctionnalités de serveur simulé. Avis collecté par et hébergé sur G2.com.

Le plan de facturation ne permet pas de passer à un nombre illimité d'utilisateurs invités de Studio ni à un nombre significatif de rédacteurs de Studio sans coûts importants. Je souhaite utiliser Stoplight pour mes API publiques et internes avec des utilisateurs invités illimités.

L'absence de support pour les spécifications gRPC et AsyncAPI.

L'absence de support pour les fournisseurs d'authentification et d'autorisation externes ; par exemple, j'utilise auth0. Avis collecté par et hébergé sur G2.com.

Interface graphique facile, option de simulation, multi-utilisateur, exportation vers Postman Avis collecté par et hébergé sur G2.com.

- Tarification pour les startups

- Licence pour les entreprises qui utilisent beaucoup de freelances (pas des développeurs actifs tout le temps) Avis collecté par et hébergé sur G2.com.

Stoplight a très bien fonctionné pour nous pendant plusieurs années. Il facilite la gestion de plusieurs versions de la spécification OpenAPI et l'ajout de contenu explicatif supplémentaire. La génération de code est excellente. Avis collecté par et hébergé sur G2.com.

Stoplight a désactivé le service SaaS que nous utilisions sans préavis. Il était simplement hors ligne soudainement. Il leur a fallu plusieurs jours pour restaurer notre projet, m'aider à le migrer vers le nouveau service et rediriger l'ancien URL. Avis collecté par et hébergé sur G2.com.

Les modèles pour la documentation API sont assez pratiques à utiliser, et l'interface est facile à comprendre. Avis collecté par et hébergé sur G2.com.

La création d'énumérations et de tableaux est limitée. Avis collecté par et hébergé sur G2.com.

Contrôle de version, rapidité de mise à jour des informations Avis collecté par et hébergé sur G2.com.

Certaines fonctions sont un peu compliquées à utiliser au début, comme changer l'ordre des titres dans le menu de gauche. Avis collecté par et hébergé sur G2.com.

Spotlight a une culture de travail formidable, ils suivent leur éthique qui inclut la satisfaction du client, les services et le soutien. La culture de travail est incroyable, offrant force aux employés, travail et discipline. Ils suivent leurs valeurs fondamentales qui donnent les meilleurs résultats de toutes les manières. Avis collecté par et hébergé sur G2.com.

tout va bien, il n'y a pas de retour négatif Avis collecté par et hébergé sur G2.com.

Contrôle de version basé sur Git, et peut être automatisé via un pipeline CI/CD. Avis collecté par et hébergé sur G2.com.

Styles personnalisés, tant de fichiers cachés dans mon répertoire .git Avis collecté par et hébergé sur G2.com.

Facilité d'utilisation et bon nombre de fonctionnalités requises. Avis collecté par et hébergé sur G2.com.

Presque rien. Parfois, il est souhaité de travailler un peu différemment, mais ce n'est pas un problème en général. Avis collecté par et hébergé sur G2.com.

Stoplight se sent très bien pour générer, écrire et tester des fichiers de spécification OpenAPI. Il est également bien conçu pour le linting et l'aperçu des documents API dans une mise en page plus moderne. Avis collecté par et hébergé sur G2.com.

Les concurrents de Stoplight offrent une meilleure expérience pour publier la documentation de référence de l'API d'un client. Avis collecté par et hébergé sur G2.com.

C'est vraiment facile de modéliser des API avec Stoplight. Des définitions de modèle aux réponses à la documentation, cela rend extrêmement pratique pour une équipe de se coordonner. Avis collecté par et hébergé sur G2.com.

Certaines des fonctionnalités (comme la vue carte) ne sont disponibles que sur les niveaux supérieurs. Quelques bugs mineurs sur l'interface markdown pour la documentation ici et là ; rien de majeur. Avis collecté par et hébergé sur G2.com.