Is it possible to add more general documentation about your API somewhere in swagger-ui?

Not belonging to one specific endpoint. E.g. I made an optional key in every endpoint that enables to transform the response before it’s sent to the client.

yes, there is the description, which takes markdown.

example here: https://github.com/metosin/compojure-api/blob/master/examples/thingie/src/examples/thingie.clj#L27-L50

[:swagger :data :info :description] that is.

ok

I’ll try it, thanks

I’m trying to add some middleware to my api, and I’m not quite sure how to do it…this is what I have so far

(api/api
       {:middleware [#(friend/wrap-authorize % #{"user"})]
        :swagger
        {:ui "/api-docs"
         :spec "/swagger.json"
         :data {:info {:title "Cenx Topology API"
                       :description "REST API for topology data"}
                :tags [....]}}}

       (api/context "/api" []
                    (api/context "..." []
                                 ...)))

I’m adding a :middleware key to the api opts, is that not correct?

ok I added that middleware to each individual route, and it seems to have worked

I’ll do a bit more digging to see if I can apply middleware to all the routes defined in the API

ok so this seems to be working

(api/middleware
    [#(friend/wrap-authorize % #{"user"})]
…

@peyotz the :middleware api option is in the 1.2.0-alph4, where middleware is also removed. The docs are partially out of phase I guess.

ah ok, that’s good to know

[[friend/wrap-authorize #{"user"}]] works too, the duct data syntax for mw.

oh, that’s nicer..thanks 🙂