Description

The OpenAPI allows to generate automatically clients for various languages. There are however some unresolved problems with some of the constructs in the Open API - for example oneOf with single schema produces uncompilable code despite being correct specification. Another example is "key" generic name of parameter, which in Java code might cause compilation problems in some cases as "key" variable name is used internally in generated methods.

We would like to make sure that our OpenAPI specification produces compilable and usable clients when auto-client generation is used. This can be easily setup as a CI step.

Use case / motivation

We want our customers to have very easy path in using the API. Being able to use pre-generated client API in their favorite language can save many days of work for integration.

CI building the API clients + API clients published as artifacts are great way to achieve that consistently.

Related Issues
#7549