Generating an OpenAPI JSON doc from my MARS server

[Stuart Clennett 15]

Hi,

 

I can see the MARS.OpenAPI.* units exist but I'm really not sure how to use them.  I have a MARS server app and would like to provide OpenAPI JSON for consumption by other utils, like Swagger.   

 

1. How do I set this up at the 'engine/application level, and 

2. How do I provide the documentation for each resource/endpoint ? 

 

Thanks in advance.

[Andrea Magni 77]

Hi @Stuart Clennett the mechanism is included in the MARSTemplate example, so you can have a look at it. (There is an OpenAPI button in the VCL application deployment mode).

The descriptions can be added with an attribute-based mechanism (MetaDescription attribute, check MARS.Metadata.Attributes unit).

 

Sincerely,

Andrea