Jump to content
Bjørn Larsen

Attribute issues and wishes

Recommended Posts

Hi Andrea, 


I have to start documenting my API's and have looked into a simple solution using Swagger UI.

Based on the Mustache demo I got it working.  (https://petstore.swagger.io/ and specifying the local swagger endpoint from the demo).

(I created a fork and a pull request with the changes I had to do as I think this might be useful for other than me. https://github.com/andrea-magni/MARS/pull/70/files)


I am not able to get the attribute MetaVisible working. I suppose this is an attribute to hide endpoints from the documentation, or am I wrong?


One other thing that I think would have been nice; is an attribute for specifying the Response.StatusCode for an successful request. 

For instance: a POST request often has StatusCode 201, while DELETE has 204, etc. 

Maybe this attribute could be used in the Metadata classes as well, and end up in the swagger documentation?


Best regards, 


Share this post

Link to post

Hi @Bjørn Larsen,

I will check this out ASAP (probably later in the afternoon).

The MetaVisible attribute was the last one I introduces so I have the fear it is unfinished but I need to check to be sure.


I agree the Swagger generation needs some love and I also have a couple of other contacts looking for the same features.




Share this post

Link to post

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now