Stoplight Avantages et Inconvénients

Ce que je préfère chez Stoplight, c'est qu'il permet aux développeurs de faire évoluer rapidement des programmes API standardisés, collaboratifs et bien gouvernés. Il rend également la conception et la documentation des API beaucoup plus simples, rapides et efficaces. Avis collecté par et hébergé sur G2.com.

La seule chose que je n'aime pas à propos de Stoplight, c'est qu'il peut être coûteux pour les petites équipes ou les développeurs individuels. Avis collecté par et hébergé sur G2.com.

N'importe qui peut modifier la documentation. Cela peut être fait via l'éditeur frontal ou via git. Avis collecté par et hébergé sur G2.com.

Il y a deux clics pour accéder à la documentation. Vous ne pouvez pas ajouter de documentation sur la page d'accueil. Avis collecté par et hébergé sur G2.com.

Facilité de création de documentation API et de partage avec des collaborateurs

Contrôle de sécurité pour maintenir la documentation interne et externe Avis collecté par et hébergé sur G2.com.

Dans le plan de démarrage, il n'est pas possible de savoir qui a effectué les modifications. Avis collecté par et hébergé sur G2.com.

Il a une excellente interface utilisateur et est facile à apprendre en tant qu'utilisateur novice pour la première fois. Je peux gérer tous les processus de conception de projet avant de gaspiller de l'argent sur un codage compliqué. Maintenant, tout est prêt avec des maquettes de démonstration et une API simple. De plus, c'est open source, et cela peut être l'une des meilleures raisons pour lesquelles je l'ai utilisé pour mes projets. Avis collecté par et hébergé sur G2.com.

Il n'y a aucun inconvénient à cette fantastique plateforme open-source. J'aime toutes les fonctionnalités et spécifications. Avis collecté par et hébergé sur G2.com.

La meilleure chose est que vous pouvez commencer gratuitement et explorer, en fait, dans la plupart des cas, la version gratuite est plus que suffisante. Convivial et intuitif, j'ai littéralement écrit toutes mes API d'application en quelques semaines. Avis collecté par et hébergé sur G2.com.

La liste des API est assez compliquée à trier, s'ils peuvent rendre ce panneau de gauche glisser-déposer, il sera plus facile de déplacer les API vers le haut et vers le bas.

Aussi, lors de la création d'une API, j'ai marqué oui pour le serveur mock, mais maintenant je n'en ai plus besoin et il n'y a pas d'option pour le désélectionner.

Dans le cas de l'utilisation de la référence à un paramètre global, il n'y a pas d'option pour le marquer comme obligatoire, vous devez le marquer comme obligatoire au niveau global. Avis collecté par et hébergé sur G2.com.

Super utile pour diffuser des informations d'une manière utile aux clients et facile à comprendre. Avis collecté par et hébergé sur G2.com.

Le modèle de tarification pour les utilisateurs rend les fonctionnalités privées irréalistes pour les entreprises en démarrage. Avis collecté par et hébergé sur G2.com.

Nous utilisions SwaggerHub pour documenter les points de terminaison API, en passant à Stoplight, les choses se sont améliorées et accélérées, l'interface utilisateur aide beaucoup ! Avis collecté par et hébergé sur G2.com.

aimerait voir les options de documentation gRPC. Avis collecté par et hébergé sur G2.com.

Un outil facile à utiliser avec d'excellentes fonctionnalités. Excellent outil pour créer des documents API. Avis collecté par et hébergé sur G2.com.

Il pourrait y avoir un moyen plus simple de publier la documentation sans avoir besoin d'inviter un membre à l'espace de travail dans le plan gratuit. Avis collecté par et hébergé sur G2.com.

C'est facile de créer des documents API qui s'adressent à la fois à des publics techniques et non techniques (qui pourraient essayer de décider si cela fonctionnera pour eux à un niveau élevé). Avis collecté par et hébergé sur G2.com.

Je n'ai rien trouvé de particulièrement déplaisant jusqu'à présent. Avis collecté par et hébergé sur G2.com.

nous avons utilisé Spotlight pour la documentation de l'API et le linter de syntaxe YAML, qui est la meilleure partie de cet outil. De plus, il aide à héberger la documentation des spécifications de l'API. Dans l'ensemble, cela en vaut la peine. Il prend également en charge les plugins GitHub pour prendre en charge les branches de développement et la stratégie Git. Avis collecté par et hébergé sur G2.com.

- L'éditeur de spécifications API doit être convivial

- Les plugins Github ne sont pas très précis lors de la récupération depuis l'origine ; s'il y a des conflits, ils échouent. Par conséquent, nous devons supprimer la branche et en créer une nouvelle. Avis collecté par et hébergé sur G2.com.