@seantempesta did you set the :securityDefinitions?

e.f. set swagger-data:

{:securityDefinitions
 {:api_key
  {:type "apiKey"
   :name "x-apikey"
   :in "header"}}}

that should trigger the Authorization-feature in the ui.

maybe there should be a pre-integrated auth feature, which would emit these too…

speccing xml sounds like lots of typing -- the problem then will be that clojure's representation of xml (and my specs for it) will have to be converted to swagger's expected format as described at https://github.com/OAI/OpenAPI-Specification/blob/master/fixtures/v2.0/json/models/modelWithXmlAttributes.json

@vale the reitit + spec + XML. If you have a XML body parsing middleware mounted, you need to describe the Swagger XML stuff manually for specs. Haven’t heard that there is a automatic converter for spec -> SwaggerXML (or XML Schema). Something like:

(require '[clojure.spec.alpha :as s])
(require '[spec-tools.core :as st])

(s/def ::id
  (st/spec
    {:spec int?
     :json-schema/xml {:attribute true
                      :namespac "ns1"
                      :prefix "urn1"}}))

(s/def ::items
  (st/spec
    {:spec (s/coll-of string?)
     :json-schema/xml {:wrapped true}}))

(s/def ::model
  (st/spec
    {:spec (s/keys :opt-un [::id ::items])
     :json-schema/xml {:name "XMLModel"}}))

(require '[spec-tools.swagger.core :as swagger])

(swagger/transform ::model)
;{:type "object"
; :xml {:name "XMLModel"}
; :properties {"id" {:type "integer"
;                    :format "int64"
;                    :xml {:attribute true
;                          :namespac "ns1"
;                          :prefix "urn1"}}
;              "items" {:type "array"
;                       :items {:type "string"}
;                       :xml {:wrapped true}}}}

not sure it’s worth the trouble defining all the fields like that, you can always write the swagger spec by hand. Just paste anything valid under :swagger and it should work.

… but the integration here is that any keys for Spec data that starts with json-schema is merged on top of the normal spec->swagger/json-schema conversion.

(with the json-schema ns stripped off that is)

wow! i think i'll need to read this 3 times over to comprehend

this is great reference, thanks! i'll be sure to get back to you once i got it to work (hopefully tomorrow)

your welcome

@seantempesta you need to put it route data under :swagger, to any place that is in the path to the endpoint serving swagger spec. E.g. here: https://github.com/metosin/reitit/blob/master/examples/ring-swagger/src/example/server.clj#L22

the :config in the swagger-ui-handler is for swagger-ui configuration, described here: https://github.com/swagger-api/swagger-ui/blob/master/docs/usage/configuration.md