MicroProfile OpenAPI—Design First with Quarkus

Wed, 19 Nov 2025 00:00:00 +0000

In an earlier article on the OpenAPI design-first approach I compared openapi-generator and swagger-codegen. Now I'm revisiting the topic by adding the Quarkus OpenAPI Generator to the comparison.

MicroProfile OpenAPI—Design First

Wed, 27 Mar 2024 00:00:00 +0000

You're given the task of writing a microservice AND providing a documentation in OpenAPI format. You already know that there are two main approaches:

code-first : write the code, using OpenAPI annotations, and then generate the OpenAPI document
design-first : write the OpenAPI document (a.k.a. the openapi.yaml file) and then generate the code

This is the second article in a series and reviews the design-first approach, the code-first approach was the subject of the first article.

Openapi-Generator on Pesches Schlauch

MicroProfile OpenAPI—Design First with Quarkus

MicroProfile OpenAPI—Design First