Fork me on GitHub
#ring-swagger
<
2018-08-20
>
rbarker06:08:37

I can’t find any specific documentation that lists all the meta-data that you can explicitly provide when creating an endpoint. The best that I can find is this snippet https://github.com/metosin/compojure-api/wiki/Swagger-integration#just-data We aren’t using Schema or Spec for validation but still want to document the application routes with Swagger and are using compojure-api

ikitommi06:08:09

@sooheon Tested and your initial code seemwork ok (2.0.0-alpha23)

ikitommi06:08:33

@rbarker there is () for the repl.

ikitommi06:08:05

but, if you only need swagger, you can use :swagger for everything.

ikitommi06:08:34

(GET "/api" []
  :swagger {:description "endpoint", :responses {200 ...}}
  (ok)

rbarker06:08:45

is there a list of everything that you can put in that map for the :swagger key?

ikitommi06:08:27

the :parameters and :responses can use Schema (or Spec) definitions instead of JSON Schema definitions.

ikitommi06:08:57

sorry, no guide. happy to see a PR of an example c-api app with just swagger docs.