3 ms·
One challenge around OpenAPI right now is that most of it is still stuck in version v2, with relatively immature support for v3. And v3 is quite different. Not
by atombender 8y ago
One challenge around OpenAPI right now is that most of it is still stuck in version v2, with relatively immature support for v3. And v3 is quite different.
Not too long ago, I tried to build a project around OpenAPI, trying to generate model structs in Go from OpenAPI definitions. The support just wasn't there. There were code generation tools for v2 and emerging library support for v3, but nothing that covered both.
I went back and used plain JSON Schema for my models, and used GraphQL instead of OpenAPI for the API, and that turned out great.
- wing328hk 8y agoPlease give it a try with OpenAPI Generator (https://openapi-generator.tech https://openapi-generator.tech), which supports both OpenAPI spec v2 and v3 for code generation.
- smt88 8y agoV3 support is good these days for most languages. It's a delight to generate TypeScript types and then have the compiler tell you all the places you need to change code because your schema changed.