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?
Public Cloud
If public cloud, private cloud, or hybrid cloud, which cloud provider do you use?
Amazon Web Services (AWS)