BEST TOOL FOR API DESIGN DOCUMENTATION
What do you like best about the product?
SmartBear SwaggerHub is a platform designed for API design, documentation, and testing, offering a collaborative environment for teams to work on their APIs. It's known for its ability to enforce OpenAPI standards, manage API evolution, and integrate with CI/CD pipelines. While praised for its user-friendly interface and ease of integration, some users find the API testing functionality limited and suggest improvements in integration with microservices and cloud technologies.
What do you dislike about the product?
Some key drawbacks include the complexity of integration with existing projects, potential performance issues with larger projects, and limitations in collaboration features. Additionally, the free version has limited functionality, and some users report that refreshing the page can reset the payload and query parameters.
What problems is the product solving and how is that benefiting you?
API Hubs help solve several key business challenges related to API management and integration. They address the need for centralized discovery, streamline development processes, enhance security, and improve collaboration among teams. By providing a central location for APIs, API Hubs simplify the process of finding, understanding, and using APIs, ultimately boosting development efficiency and accelerating time to market for new products and features.
Centralized platform management by api hub
What do you like best about the product?
Simple Ui easy to understand with theme based feature, Auth token functionality
What do you dislike about the product?
Filter options and non persistent data on reload
What problems is the product solving and how is that benefiting you?
API testing
Nice and Easy to use
What do you like best about the product?
This makes the developers to view the contracts easy and understand the API responses and request
What do you dislike about the product?
It was a perfect platform no dislike and easy to use
What problems is the product solving and how is that benefiting you?
It is helping for the end user or developer to understand the contract and easy to interact with
How API Hub helped collaboration and reduced KT times
What do you like best about the product?
The most helpful feature is the ability to create and edit OpenAPI definitions in a collaborative, web-based editor.
What do you dislike about the product?
The pricing seems to pricy sometimes and i hope if it can be more affordable
What problems is the product solving and how is that benefiting you?
Easy to collaborate and maintain role based access .
Facilitating enterprise-wide API governance and management
What is our primary use case?
I started using SwaggerHub in its previous version, SmartMiner, with a tool called SoapUI. I used it to create mock web services to test web services and create test scripts and mock APIs.
This usage began in 2009 or 2010. Later, I adopted SwaggerHub as the platform evolved into Swagger and now OpenAPI, to create APIs.
What is most valuable?
One of the best features of SwaggerHub is how it allows me to create APIs and control the evolution of APIs within an organization. It serves as a central hub for API design, development, adoption, and management. I can create different teams within an organization and expose these APIs to other parts of the organization. SwaggerHub facilitates enterprise-wide governance and standardization in API adoption.
What needs improvement?
Some areas of SwaggerHub that could be improved include the interface between the code editor and the visual editor, the integration with private APIs, which currently requires an upgraded account. The scalability also needs enhancement, as it becomes flaky under increased load.
Additionally, the versioning management could be improved to be on par with source code management tools.
For how long have I used the solution?
I have been using SwaggerHub since its version as SmartMiner's SoapUI, which began around 2009 or 2010.
What do I think about the stability of the solution?
When load testing and stress testing SwaggerHub, it becomes a bit slow to react under extreme conditions. However, overall, it is stable for the most part and has improved over time.
What do I think about the scalability of the solution?
The scalability aspect of SwaggerHub can be improved. It becomes a bit unreliable when the load is increased and isn't up to par with expectations for scalability.
How are customer service and support?
The support from SwaggerHub is decent yet not the best. The response time needs improvement as it takes a while to receive a response.
How would you rate customer service and support?
Which solution did I use previously and why did I switch?
Previously, I used SmartMiner with a tool called SoapUI before transitioning to SwaggerHub.
How was the initial setup?
The initial setup for SwaggerHub is straightforward and allows setting up a basic API quickly, within 15 to 30 minutes.
What's my experience with pricing, setup cost, and licensing?
Regarding pricing, while I do not have specifics for SwaggerHub, I recall licensing costs for SoapUI being around $600 to $700.
What other advice do I have?
For newcomers, it is advisable to start small. Have one team use SwaggerHub initially, and then expand as needed. If you have existing APIs, begin by using SwaggerHub to test and standardize them. For new developments, adopting an API-first design is beneficial.
I rate SwaggerHub as eight out of ten. It has grown significantly over the years.
Good experience with swagger Hub
What do you like best about the product?
Main advantage is the automatic generation of client and server SDKs in various languages, that expediting the development process.
What do you dislike about the product?
I could not found any concern as such while using swagger hub.
What problems is the product solving and how is that benefiting you?
This platform that helps teams to design, document, and test APIs.
collaborative platform for managing api's
What do you like best about the product?
It's Integration with DevOps Tools is something which I like the most.
What do you dislike about the product?
I am still not sure if there is anything which i dont like.
What problems is the product solving and how is that benefiting you?
To manage all my api's at the same time and integrate it with different platforms is benefitting me.
My API development journey with SwaggerHub
What do you like best about the product?
I use SwaggerHub frequently to create API Documentation.
Easy to test the api's locally before deployments.
Simple to export the code to the programming language of my choice and implementation is made easy.
Able to test API security with OAuth Authentication.
Easy to validate API requests and integrate to other systems.
Easy to copy/download curl requests.
What do you dislike about the product?
Free version has limited features.
Once we refresh the swagger, json payload will be reset to default and query parameters will be erased.
Team collabration options are limited.
What problems is the product solving and how is that benefiting you?
To share API documentation across the teams
Swagger: A Tool for testing my work
What do you like best about the product?
The UI is simple and clean, Provides ease of access to new users. The authentication token can be configured easily. I use it in my daily development activities. The APIs I wrote, I test them using swagger. After I test my APIs through swagger, then I will start integration with frontend APIs. With some additional configuration swagger persists auth token, changes theme, displays response time too.
What do you dislike about the product?
If we reload swagger then all the request body we made earlier for APIs will be erased, we should have a persistence option to save requests. For example postman supports saving requests etc. Swagger Filter option is not upto the mark.
What problems is the product solving and how is that benefiting you?
Testing APIs before integrating them with frontend, helps me to make backend APIs strong and stable before I move to frontend development
Overall a good tool to have API documentation and test using several Instances
What do you like best about the product?
Its structured documentations help alot while doing any integerations
What do you dislike about the product?
Its authorization, some time become glitchy need to reauthorise it
What problems is the product solving and how is that benefiting you?
Now, we have a platform which is shared among external developer and they can easily go through the API which we are exposing and can test it there itself and vice versa
