Documenting ApiModel using static JSON schema with Jersey 2 + Swagger

[Miika Alonen]

Hi,

I have a case where some of the API responses are fetched directly from the graph database as JSON. I would like to document these API:s to look similar as using ApiModel and ApiModelProperty annotations. Is it somehow possible to document the model for the swagger ui using reference to external (static) JSON schema model?

[Ron Ratovsky]

You can reference other definitions from @ApiModel - http://docs.swagger.io/swagger-core/current/apidocs/io/swagger/annotations/ApiModel.html#reference().

--
You received this message because you are subscribed to the Google Groups "Swagger" group.
To unsubscribe from this group and stop receiving emails from it, send an email to swagger-swaggers...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[Rupert Smith]

 Thursday, March 3, 2016 at 3:51:48 PM UTC, Ron wrote:

You can reference other definitions from @ApiModel - http://docs.swagger.io/swagger-core/current/apidocs/io/swagger/annotations/ApiModel.html#reference().

Looks like what I need. How do you use this? Do you put in the full path of a class as the string value of 'reference'? Or is this where you put a json-schema reference? If its a reference to some piece of json-schema, how do you get that added to the generated docs too?

Rupert