Avis et détails du produit de Swagger UI

Facile à mettre en œuvre, et publier.

Vient avec un json pré-rempli (json généré automatiquement)

La documentation devient automatisée

Important pour les ingénieurs frontend, backend et produit Avis collecté par et hébergé sur G2.com.

Il y a des accordéons utilisés, donc vous devez faire défiler vers le bas pour ouvrir les accordéons afin de voir, pour chaque point de terminaison. Un bouton en haut pour ouvrir tous les accordéons ensemble peut être mieux. L'UX peut être encore améliorée, en gardant un tiroir de glossaire (Table des matières) à droite et le corps principal du contenu peut être au centre présentant le point de terminaison. Ainsi, on peut facilement passer à un autre en cliquant sur la Table des matières. Donc, fondamentalement, l'UX peut être améliorée. Avis collecté par et hébergé sur G2.com.

Son interface utilisateur et sa manière d'application sont très bonnes. De plus, il est très facile à mettre en œuvre. Avis collecté par et hébergé sur G2.com.

Rien, c'est une bonne application pour le test d'API. Avis collecté par et hébergé sur G2.com.

Swagger fournit la documentation des API de manière interactive avec tout ce qui est nécessaire pour documenter, par exemple le type d'API comme GET, POST, DELETE, PUT, PATCH, etc., et le point de terminaison de chaque API, les paramètres de requête et de réponse et le type de réponse, par exemple 400, 200, 401, etc. Tout est placé en un seul endroit de manière bien organisée et belle. La meilleure partie est qu'il est facile à utiliser et à intégrer avec votre outil, par exemple Spring Boot, vous avez simplement besoin d'ajouter la configuration, c'est tout, tout est documenté automatiquement. Il fournit même un accès basé sur des jetons pour les API, ce qui les rend sécurisées, personne ne peut les utiliser sans un jeton approprié. Son interface utilisateur est conviviale et vous pouvez même la personnaliser. Vous pouvez héberger vos API avec la documentation Swagger, ce qui améliore l'expérience des développeurs et rend la meilleure documentation facilement disponible sans beaucoup d'effort. J'adore cette documentation des API et je n'ai jamais cherché un autre outil depuis que j'ai commencé à l'utiliser. Avis collecté par et hébergé sur G2.com.

je l'utilise depuis 2,5 ans et je n'ai rien trouvé à redire sur Swagger. j'adore l'utiliser. Avis collecté par et hébergé sur G2.com.

Amélioration de la découvrabilité de l'API,

Automatisation de l'API plus rapide

Réduction de la maintenance de la documentation Avis collecté par et hébergé sur G2.com.

Courbe d'apprentissage abrupte, Complexité de configuration Problèmes de performance Avis collecté par et hébergé sur G2.com.

The best thing I personally like about swagger the UI/UX.

It has its own unique way of presenting the Rest API operation using unique colours for each of the operations (GET: blue, POST: green, PUT: yellow and DELETE: red). Also we can provide proper example of the schemas/structure for each type of error codes, which inturn helps user to understand the operations more easily Avis collecté par et hébergé sur G2.com.

As far as I know I havent come across any major point that I have disliked. One of the minor point I've noticed is that if we havnt performed any operations for a long time, it is usually timedout. But the frontend user would not know and it just provides a 401 code without any extra validation. This misleads the user that he doesnt have the permission to perform the action. Instead we should just re-authenticate. Avis collecté par et hébergé sur G2.com.

I don't know of a single alternative to Swagger UI for documenting & testing APIs that is as feature-rich.

1. Has in-build API testing which supports authentication custom payloads.

2. Can easily see all the different types of response models, errors - a server can return.

3. Has a big developer community around it & a lot of libraries for integration in Django, express, ruby on rails, etc. Avis collecté par et hébergé sur G2.com.

Would really like if there was a sort-of drag-and-drop for simple APIs that can output static swagger ui HTML, CSS, JS files that I can easily host on something like GitHub pages. Without having to write the complete OpenAPI spec. Avis collecté par et hébergé sur G2.com.

Swagger est la plateforme où une personne sans aucune connaissance peut essayer les tests d'API même sans connaître tout sur JSON et XML. Avis collecté par et hébergé sur G2.com.

Si je génère un jeton d'authentification et ensuite j'ai besoin d'obtenir des données dans un module différent. Passer du premier au second est lent ou se bloque. Dans certains cas, je dois fermer le navigateur et le redémarrer. Cela affecte la productivité lors d'une journée chargée. Avis collecté par et hébergé sur G2.com.

Swagger UI est le meilleur pour la documentation API, en plus de cela, vous pouvez tester vos API et la meilleure fonctionnalité, je peux dire, est qu'il prend un jeton pour l'authentification. Avis collecté par et hébergé sur G2.com.

Il doit y avoir un message d'erreur approprié lorsqu'il y a un problème avec l'interface utilisateur de Swagger en raison du code. Avis collecté par et hébergé sur G2.com.

It simplifies for the users to get the info and work on it at one go... helps collaboration with other teams or members to use our team API s. I use it everytime for every application I develop on to help others understand it.It has easy library imports for Go and for python as well. Pretty easy to implement. Avis collecté par et hébergé sur G2.com.

nothing to dislike .. makes developers' everyday life easy. I use it atleast once per week to write for the apis I use... never felt difficulty in self understanding. Swagger UI team supports customers to preview as well. Avis collecté par et hébergé sur G2.com.

Il utilise un système de documentation standard pour documenter l'API. Avis collecté par et hébergé sur G2.com.

vous ne pouvez pas écrire de scripts pour vos tests d'API avec cet outil Avis collecté par et hébergé sur G2.com.