Introduction

OpenAPI is a specification for HTTP oriented API definitions

•The Home Page for OpenAPIs

•The Home Page For AsyncAPI

•The Home Page for OpenAPI Generator tool

•Home Page for IBM Schema Validator

Installation OpenAPI Generator

Under Ubuntu LTS18.04 you have to install at least node >= 12. So here are the information for installation of Node 14:

sudo su

su -c 'curl -sL https://deb.nodesource.com/setup_14.x | bash -'

su -c 'apt update'

su -c 'apt install -y nodejs'

node --version

First you have to install npm via:

sudo apt install npm

Then you can install the generator tools like:

npm install @openapitools/openapi-generator-cli -g

Consideration when using OpenAPI Generator

Generator "csharp-netcore", "csharp"

•You must not define attribute names starting with "_", not an error, but the generator just removes the "_" and suddenly a "_cid" is now a "cid". The problem is, that the generators try to convert a "_" (snake_case) to camelCase ... and in this process the "_" gets lost.

•Attribute name and json parameter name must be equally named, the JSON name is the name of the generated attribute