Design First approach to microservice APIs
June 10, 2021

Design First approach to microservice APIs

Anonymous | TrustRadius Reviewer
Score 10 out of 10
Vetted Review
Verified User

Overall Satisfaction with SwaggerHub

We use SwaggerHub to design our micro service APIs prior to development starting. Our Solution Architect's and Technical Business Analysts are able to collaborate and define the APIs based off user stories. Our Swagger API definitions are a core part of our customer facing documentation, so we put a lot of effort into that design phase to make sure we have consistent naming standards and have great descriptions and examples for each endpoint. Our customers can read our API documentation to understand what each API does, and they can also import the Swagger definitions and code stubs into their IDEs to give them a head start on the development process.
  • Treating the design as documentation ensures that we have consistent and well defined APIs
  • API consumers can export the swagger definition or code stubs to use within their development environment
  • We can iterate through multiple versions of a definition privately before making a version publicly available
  • Under the Swagger 2.0 standards you can only provide one example for each endpoint. A complex /search endpoint is a great use case for having multiple examples.
  • Not able to define events that will be created or consumed by an API.
  • Ability to define multiple versions of each API
  • Shared domain models to ensure consistent definitions across APIs
  • Design consistency
  • Reduced rework
  • Ease of use

Do you think SwaggerHub delivers good value for the price?

Yes

Are you happy with SwaggerHub's feature set?

Yes

Did SwaggerHub live up to sales and marketing promises?

Yes

Did implementation of SwaggerHub go as expected?

Yes

Would you buy SwaggerHub again?

Yes

SwaggerHub is perfectly suited for defining an API before development starts.

SwaggerHub Feature Ratings

API versioning
9