Avis et détails du produit Swagger Studio

Nous documentons l'API avec. La manière facile d'intégrer et de générer des fichiers SDK d'API est de gérer tous les paramètres requis pour l'API comme le jeton d'authentification, etc. Le package npm OpenAPI aide beaucoup à générer des fichiers SDK. Avis collecté par et hébergé sur G2.com.

Concernant la sécurité, nous avons des préoccupations majeures. Comme il s'agit d'une offre cloud, nous devons ajouter tous les jetons et les informations d'identification de sécurité sur le portail hub pour vérifier si l'API fonctionne ou non. Cela peut représenter une menace d'ajouter ces détails sur le site tiers. Avis collecté par et hébergé sur G2.com.

J'aime la façon dont il convertit le fichier YAML de la documentation de l'API en un terrain de jeu API fonctionnel, y compris les charges utiles, l'autorisation, etc. Et aussi la gestion des versions du fichier de documents. Avis collecté par et hébergé sur G2.com.

Modifier le fichier YAML pour obtenir le résultat souhaité est pénible. Parce que l'indentation des fichiers YAML joue un rôle important. Si quelque chose n'est pas dans le bon format, l'ensemble du document s'effondrera. Avis collecté par et hébergé sur G2.com.

Un swagger est en fait un outil formidable pour documenter automatiquement votre API une fois qu'elle est intégrée, il offre une excellente interface utilisateur pour voir la structure et le schéma de l'API. Avis collecté par et hébergé sur G2.com.

nous utilisons sails.js comme framework backend et l'intégration de swagger avec sails.js est un processus vraiment difficile et pénible, le manque de tutoriels sur Internet et la documentation pour l'intégrer avec sails n'est pas vraiment excellente en fait, mais une fois intégré, cela fonctionne sans problème ! Avis collecté par et hébergé sur G2.com.

En tant que consommateur d'API, vous pouvez extraire les définitions des API et les utiliser. Pour tout design d'API, la documentation est plus critique que le code car tous les développeurs se concentreront sur les documents ; seul Swaggerhub dispose d'une excellente installation pour créer des documents. La capacité de créer des organisations est très utile. Par exemple, si vous travaillez pour plusieurs organisations, vous pouvez facilement suivre votre travail de manière indépendante. Avis collecté par et hébergé sur G2.com.

L'interface utilisateur pourrait être déroutante pour les nouveaux développeurs. J'ai vu que certaines des documentations API contiennent également des caractères indésirables. Donc, beaucoup de travail est nécessaire dans ce domaine. De plus, les tests API ne sont pas possibles. Avis collecté par et hébergé sur G2.com.

Cela facilite le partage ou l'utilisation conjointe pour des projets collaboratifs pour l'équipe et au sein du groupe, également utile aux organisations lorsqu'elles souhaitent documenter l'API. Je me sens élémentaire en communiquant sur la version du point de terminaison de l'API entre les différentes parties prenantes et équipes en utilisant la section des commentaires de swaggerHub. Swagger Hub est une plateforme logicielle open-source que tout individu ou entreprise peut utiliser gratuitement. Et peut également utiliser le support de swaggerHub pour son équipe, bien que swaggerHub facture quelques dollars pour ses fonctionnalités de package d'équipe et son support sur une base mensuelle et annuelle. Avis collecté par et hébergé sur G2.com.

La création de documentation API à partir de zéro n'est pas très conviviale pour les débutants, également un manque dans le test des points de terminaison de l'API. Lors de la mise à jour ou de la création de nouvelles entrées d'API, il n'est pas très facile de maintenir l'indentation, et cela a pris plus de temps que prévu. Avis collecté par et hébergé sur G2.com.

Très facile de partager les documents liés à l'API sans aucune intervention manuelle. Avis collecté par et hébergé sur G2.com.

L'interface utilisateur doit être améliorée. Elle devrait permettre la configuration des variables d'environnement afin que lorsqu'il y a un changement dans les détails du serveur de déploiement, il suffise de modifier les détails des variables. Avis collecté par et hébergé sur G2.com.

1. La documentation de l'API maintient l'automatisation de la documentation de l'interface utilisateur Swagger et donne tous les détails de l'API, depuis la charge utile jusqu'à la réponse.

2. La vie du développeur/QA est facilitée lors des tests des API Rest.

3. API sécurisée par un support d'authentification basé sur des jetons, afin qu'elle ne soit pas exposée au monde extérieur. Avis collecté par et hébergé sur G2.com.

1. Rien de tel mais difficile à tester OpenApi.

2. Sans lire la documentation, c'est difficile à utiliser, mais une fois que vous comprenez, cela fonctionne à merveille. Avis collecté par et hébergé sur G2.com.

Un outil de documentation open-source, gratuit et convivial pour l'API d'où tout le monde peut le vérifier et le tester. La documentation de l'API est très facile de sorte que le codage et le document connexe seront générés automatiquement. Avis collecté par et hébergé sur G2.com.

Il n'y a aucun moyen d'écrire les cas de test. Mieux si cela permet l'intégration du logiciel tiers. Avis collecté par et hébergé sur G2.com.

Ce que j'aime le plus à propos de SwaggerHub, c'est la possibilité de l'utiliser comme un dépôt et la capacité de valider mes scripts lors de leur téléchargement, ainsi que le cas de coller au format JSON ou YAML. Avis collecté par et hébergé sur G2.com.

Pour l'instant, je n'ai trouvé aucun inconvénient à mentionner. La vérité a fonctionné pour moi. Avis collecté par et hébergé sur G2.com.

C'est un excellent outil de documentation authentique pour l'API à partager parmi les clients où ils peuvent le consulter, le tester en maintenant les résultats de test en temps réel avec une authentification de base ainsi que d'autres oauth2. Je l'ai utilisé dans mes projets Laravel pour la documentation. Avis collecté par et hébergé sur G2.com.

chaque fois que nous devons générer les documents, même pour de petits changements et les codes doivent être développés avec soin, ce qui ne peut être fait sans une connaissance appropriée, donc une personne formée est requise pour cela. Avis collecté par et hébergé sur G2.com.