In those days, every Web Project has 2 parts – an API and an SPA . If we document the SPA for the users, the API is directed more to programmers- and it will be helpfull to have already generated for them SDK for the language of their choice.
There are many generators in the market – however,how to integrate into the project to see them at work ?
Let’s start with generators
- OpenAPI Generator — github.com/OpenAPITools/openapi-generator
- Swagger Codegen — github.com/swagger-api/swagger-codegen
- Kiota — learn.microsoft.com/openapi/kiota
- Orval v5 — v5.orval.dev
- AutoRest — github.com/Azure/autorest
I was thinking of integrating with ASPIRE – and generating SDK on demand on various languages.
But first – an architectural question: If we have 2 WebAPI projects, you want a generator for both WebAPI – or each WebAPI has his own generator ?
( You can test already at https://github.com/ignatandrei/aspireExtensions/tree/main/src/WebAPIDocsExtensions or https://www.nuget.org/packages/WebAPIDocsExtensionAspire)