Enhancing Swagger documentation and functionality - Mendix Forum

Enhancing Swagger documentation and functionality

72

Hi,

when building published REST API’s the easiest way to test these should be via the Swagger that Mendix generates. Unfortunately, most of the times there is a reaon why we can’t use it, because the Mendix Swagger is too basic.

Is is possible for Mendix to enhance the swagger functionality?

This can be done by either:

  1. Let developers upload a custom swagger.json file with total freedom via Studio Pro, or as a file in the project folder that will override the auto-generated swagger
  2. Simply improve the automatically generated file
    1. Add headers, for example for authorization
    2. Add custom response codes, for example for error handling
    3. I’m probably missing things now that the Mendix Swagger doesn’t cater for, please feel free to add improvements :-) 
asked
5 answers

@Andrej, please also take 'automatic' naming conventions under consideration (see https://community.mendix.com/link/space/integrations/ideas/3783)

Created

Addition: show an example for mappings based on JSON (this only seems to work for mappings from a message definition)

Created

I really love to get a feature to either put custom documentation , yml or json . The multiple sample example response are must to have.

Created

Addition: Support for enumerations, such that consumers know the possible values of that string.

Created

This would indeed be very handy.

Created