Has streamlined API documentation and integration workflows across cross-functional teams
What is our primary use case?
SwaggerHub includes multiple tools such as Swagger Editor, Swagger UI, and Swagger Codegen. We use SwaggerHub mainly to test our APIs, build and support, extend the APIs, and we generally test them with our applications or tools to determine if we can fetch something or perform activities towards our company's portal.
We use this mainly on SwaggerHub where we build APIs, test them, publish them, and we let developers and other users use it for their internal automations or whatever they want to use.
We have a third-party tool called IP management and operations where we wanted to get the list of IPs and allocate to the servers to determine the available IPs we have and how much capacity we can assign to individual servers. Using that IPAM tool or the IP tool, we created an API using SwaggerHub where we added some scripts and tasks to get the relevant details and we published that API integrating with that tool.
Once we completed that publishing, the developers can access the list of available IPs from the IPAM tool using that API and then they can fetch how many available IPs exist in that particular pool and what next available IP they can allocate to their servers which they want to spin up or create anything.
Being a DevOps engineer, we don't do end-to-end things on SwaggerHub, but we mainly interact with fixing things, implementing things, and working with SwaggerHub and using their APIs or publishing the APIs and doing documentation. The recent use case that I have interacted with where our SSL certificate had gone haywire, so we wanted to fix something on SwaggerHub, and we followed their documentation in order to fix it, and we finally were able to achieve it. That is the last thing that we worked on SwaggerHub because our SwaggerHub is running on an AWS server, which is a standalone server.
What is most valuable?
There are multiple features, but the main feature that I appreciate about SwaggerHub is their documentation part, where you can easily get the documentation for any API you have created. You can easily publish the documentation and share it with your developers or team members.
The second feature is their UI, which is very easy to use and very interactive. You can easily drag and drop things, create APIs, test APIs, and publish APIs. The third feature is their integration part. You can easily integrate SwaggerHub with other third-party tools or applications, as we have integrated with the IPAM tool.
Most companies mainly rely on automations to get things done better rather than doing it in a manual way. SwaggerHub provided us an interface to interact with other tools and collaborate and work with the developers and the cross teams.
That is where all teams can combine and work productively and effectively and reduce many man-hours to fix things and make things easier and quicker. In this way, SwaggerHub plays a crucial role in order to bring teams and automate things faster and also reduce the man-hours and increase the work efficiency.
By building the collective APIs and endpoints, SwaggerHub has roughly downgraded the user operations by about 40% of manual needs by bringing the automations and interacting the APIs and open API endpoints.
This part has saved many hours of fixing the errors and going through every part and understanding where exactly this has caused. SwaggerHub plays a crucial role here by giving crisp solutions where we can interact with other tools and technologies using the API ecosystems. This can reduce around 40 to 50% of man-hours using their tool and automation.
What needs improvement?
Documenting SwaggerHub has a standard and consistent structure of API definitions, and it automatically generates interactive documentation which helps the developers to understand everything. There are certain areas where SwaggerHub can go beyond here as formatting options for documentation pages are restricted, and the import and export options of API collections are complex in SwaggerHub. It provides various collaboration tools where we can work and do it.
The strong validation against the API maintains conformity and reduces errors. That part is very great in SwaggerHub. Overall, scalability and stability-wise, it varies high compared to the competitors, but there are still certain areas where competitors are providing various customizations. SwaggerHub can understand those aspects and implement them as well.
The complex import and export of API calls and collaborations can be challenging in SwaggerHub. If they can make it easier for us, that would be great. Their performance is degraded if there is too much load on the API. The customization and doc formatting options for documentation pages are restricted in SwaggerHub. A few of my teammates have complained that they find the UI unintuitive where it requires multiple clicks for simple tasks. SwaggerHub is a great tool, but these limitations can be addressed to make things better and easier.
For how long have I used the solution?
I have used SwaggerHub for over two years, where we usually create and manage APIs in SwaggerHub, company-level APIs where we interact with some other tools, the third-party tools where we wanted to integrate and test them.
I have used SwaggerHub for around two to three years and my last interaction with SwaggerHub was around six months back, where I hosted SwaggerHub on an AWS server.
What other advice do I have?
If they wanted to build or customize anything related to APIs or whatever they wanted to achieve, SwaggerHub is the best option and I feel they can absolutely go for it compared to the other tools which are existing in the market.
SwaggerHub stands great at the enterprise level. The way it is performing right now is solid and great. I rate SwaggerHub 8.5 out of 10.
Which deployment model are you using for this solution?
smartest way to handle and test API's
What do you like best about the product?
This is the best for API Testing and API visualization. easy to use, easy to maintain. all my apis are easily accessible, easy to visualize.
What do you dislike about the product?
there is nothing to dislike. I like every feature
What problems is the product solving and how is that benefiting you?
earlier using postman its hard to visulize how api is actually working but through smart bear its easy to view and manage also easy to create api documenatation
Very good service for creation of api documentation
What do you like best about the product?
API Hub provides good interface for creating the API documentation.
What do you dislike about the product?
It is not free model. They can provide trials to improve this.
What problems is the product solving and how is that benefiting you?
It is so easy for us to make the documentation of the API from the same and after loading the YAML file, it provides us very good UI to check the documentation and test it also.
API management functionality has improved with seamless integration and centralized documentation
What is our primary use case?
I have worked for Arden University, University of Sheffield, and Nanyang Technological University. For those institutions, I used Amazon AppStream for backend validations.
When working for Prolifics, I used it for backend validations and data creation. In our testing, we had different sets of environments, such as Test, FT, UAT, and sometimes the Dev instance, where we performed validations.
My recent project, DDI (Direct Device Interface), involved a client, Thermo Fisher Scientific, which is a product-based company. In this project, there was a Tune application they had already developed in the desktop version, and they were planning to switch it to the cloud. There, I performed API testing using Swagger and API testing.
I have used automated validations and testing features to support API quality control in my projects.
Automation, using Swagger validations in CI/CD tools, has helped catch schema mismatches early. In one of my recent projects, the backend team made changes to a response object by adding a new required field without updating the Swagger specification. Because we had Swagger CLI validations integrated into our Jenkins pipeline, it caught the mismatch immediately, thereby preventing breaking changes and facilitating faster feedback with automated Postman.
What is most valuable?
SwaggerHub has significantly improved how my organization designs, documents, and manages APIs, centralizing API management so that all API definitions are stored in one location, which makes it easy for stakeholders, developers, QA, DevOps, and products to access the latest version. It has improved collaboration through role-based access tools, streamlined API design, and review processes, and accelerated development cycles while reducing errors and reworking through automated validations that catch issues early.
One of the best features I appreciate about Swagger is the interactive API documentation it offers, which has saved me a lot of time during validations and exploratory API testing as a QA engineer.
For Swagger, I used it primarily for the API design and documentation as it is integrated into the SmartBear ecosystem. It supports open API specifications and helps create clear, machine-readable documentation. With Swagger UI, developers and testers can view the API endpoints with alternative web interfaces. Additionally, Swagger can generate server stubs and client SDKs in various programming languages automatically, saving a lot of time and reducing manual errors.
What needs improvement?
In SwaggerHub, I appreciate that it is a powerful platform for API design and collaboration, but currently, the access control is somewhat limited. I would love to see enhanced permissions allowing a user to comment without edit access or granting edit access to specific sections of the API specification. Better integration with CI/CD pipelines would also be beneficial, making the integrations more native and streamlined, especially for managing API specifications across different environments while avoiding manual duplications or workarounds.
For how long have I used the solution?
My experience with the AppStream is more than a year.
What do I think about the stability of the solution?
During my experience with SwaggerHub, it has been quite stable overall. I have not encountered any major performance issues, crashes, or unplanned downtimes. The cloud-hosted version we used was reliable and responsive, even with multiple users collaborating on the same API simultaneously. However, there were brief lags or slow loading times when working with very large or complex open API specs, but these occurrences were rare and didn't disrupt our work.
What do I think about the scalability of the solution?
SwaggerHub has proven scalable, especially in a team environment with growing API definitions and multiple collaborators. We worked with several large and complex open API specifications, including multiple endpoints, schemas, and reusable components, that it handled smoothly. While we noticed slight performance lags when loading very large specs, it never became a blocker.
How are customer service and support?
I have not had to reach out to SwaggerHub technical support directly, as most issues we faced were either minor or could be resolved internally through documentation and forums.
How would you rate customer service and support?
Which solution did I use previously and why did I switch?
I have not worked with any other API management solutions, as I had limited opportunities to perform API testing, having used only Swagger and Postman in my previous organization.
How was the initial setup?
I wasn't directly involved in the initial setup or deployment process of SwaggerHub. However, once it was integrated into our development workflow, I became deeply involved with it.
What's my experience with pricing, setup cost, and licensing?
While I haven't been directly involved in the procurement process, I do have a general understanding of SwaggerHub's pricing model from my experience using it in enterprise environments, but I can't provide specific details.
I am not aware of the pricing, licensing cost, or setup cost of SwaggerHub.
Which other solutions did I evaluate?
I did not evaluate any other options or solutions available on the market for API management.
What other advice do I have?
Based on my limited experience with SwaggerHub, I can share a few practical recommendations for implementing it effectively. Before onboarding multiple teams, it's important to define naming conventions and standards, and leverage reusable components to maintain consistency across APIs, which avoids tech debt in the future. Integrating SwaggerHub with Git-based workflows such as GitHub or GitLab repositories early on ensures that all API changes are traceable and synchronized with the code base.
Once we finished scripting, we push the code into GitHub so that when we want to build the project in Jenkins, we configure Jenkins to run in the backend and send reports to stakeholders. It triggers mail notifications whether the build is successful or failures, and we set configurations for user email addresses and the timing of Jenkins runs.
The centralized API management location in SwaggerHub has ensured that all teams, including developers, QA, and DevOps, work with the latest and approved API specifications to reduce miscommunication. SwaggerHub supports role-based permissions that enforce who could view, edit, and publish API specifications, which prevents unauthorized changes and helps secure workflows, especially in sensitive, regulated environments.
The documentation capabilities via Swagger UI and SwaggerHub have significantly impacted both technical and non-technical stakeholders, improving their understanding and utilization of our APIs. This has resulted in reducing support requests, increasing adoption and integration speed, and empowering non-technical stakeholders while providing improved clarity for developers and QA teams.
I rate this solution 8 out of 10.
Which deployment model are you using for this solution?
It is very helpful with understanding of publishing
What do you like best about the product?
It corrects and thoroughly explains what needs to be understood
What do you dislike about the product?
It doesn't give you different options if paragraphs or languages
What problems is the product solving and how is that benefiting you?
It offers clear direct statements and spelling and grammar
Solid platform for API lifecycle management with strong governance features
What do you like best about the product?
The best part is how clean and developer-friendly the UI is. Designing APIs using OpenAPI spec is smooth, and the branching/version control feels like Git but made for API documentation. It really helps keep everything consistent across teams.
What do you dislike about the product?
The ability to enforce API design standards using style guides is a huge plus. Our team uses it to maintain uniformity across services. Integrations with GitHub and contract testing tools like PactFlow make CI/CD workflows much more reliable
What problems is the product solving and how is that benefiting you?
API Hub helps our teams standardize and centralize API design and documentation. It eliminates inconsistencies across services by enforcing design rules and making collaboration seamless. We no longer waste time managing multiple Swagger files or worrying about breaking changes in APIs. It’s also improved our DevOps efficiency by integrating contract testing early in the pipeline.
API Hub Review
What do you like best about the product?
It is centralized API design like it provides a signal source of truth for API definitions. API mecca allows druggies to design, document, and manage APIs using the OpenAPI Specification( OAS) in a single platform. The real- time editor with confirmation helps catch crimes beforehand and provides live previewing, which is a big productivity boost. There are so many features as well
What do you dislike about the product?
It has limited issues, performance issues. The attestation UI is tightly coupled with Swagger UI, and customizing the look, feel, or layout is limited. However, it can be frustrating, If you are trying to deeply conform the API croakers experience for branding or usability.
What problems is the product solving and how is that benefiting you?
How API mecca Solves It
Style companion enforcement
Design- time confirmation against the OpenAPI Spec
Versioning and lifecycle operation
Benefit is insure harmonious, high- quality APIs that align with your company’s norms — reducing tech debt and perfecting maintainability.
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