ring-swagger

ring-swagger & compojure-api
thomash 2018-11-09T22:21:23.040200Z

Hi all - I'm using swagger from compojure-api, and am struggling with a few questions I seem not to find answers for in the docs: 1. I'm using specs like (def URL s/Str), and then (defschema Article {:url URL}), and would like for them to show up in the generated API docs, e.g. the models. But there, I only get Article {url (string)}. Is there a way to achieve something like Article {url (URL)} URL(string)? 2. Is there a way to add a description at the top of a (context), so that it would show up before any route documentation? I would like to add information how to use the various routes in the context. 3. I have specs like (defschema Article {:name s/Str :description s/Str}) and then use a slightly modified version of it in a route, e.g. :body-params [article :- (-> Article (dissoc :description))] or :return (-> Article (dissoc :description)). The API honors this, checking param or return value correctly. But the swagger docs always show the full Article schema!? Thanks.