Should I Use Spring REST Docs or OpenAPI? Recently, I was asked which is better to use. Spring REST Docs or OpenAPI. From the perspective of generating documentation for your APIs, you may think these two options are effectively the same thing. But, it’s not exactly an apples to apples comparison. These are significantly different […]Continue reading
I’ve previously posted about defining Consumer Driven Contracts using the OpenAPI specification and Spring Cloud Contract. This approach works well because you can tie your contracts to your API specification, and also wire in a request validator into your contract tests. But one problem that remained is typically your OpenAPI specification will span multiple services. […]Continue reading
The Swagger Request Validator is a slick project supported by the folks at Atlassian. Using your API definition in Swagger v2 or OpenAPI v3, it allows you to programmatically validate your API matches your API specification. The Swagger Request Validator may be used standalone, or with Spring MVC, Spring MockMVC, Spring Web Client, REST Assured, […]Continue reading
Working for startups is always an interesting experience. Currently, I’m a software engineer at Velo Payments. If you’ve ever worked for a startup, you’ll quickly see that you get to wear many hats. One of the hats I get to wear is the creation of developer center (currently in the oven). In the very near […]Continue reading
