@kventil I recently looked into this (we need to
document a REST API).

• I generate an Open API 3 file from a config file
• This file is published and can be used with the online viewer
  (https://petstore.swagger.io/)
• we generate TypeScript types for the models, which are used in code