clojure - ring-swagger 中查询参数说明

Question

我正在通过 compojure-api 使用 ring-swagger。我有一些查询参数，我正在努力寻找一种将描述添加到单个查询参数的方法。我可以添加整个端点的摘要，但这还不够。

是否可以使用 ring-swagger/compojure-api 向单个查询参数添加 swagger 描述？

Answer 1

compojure.api.sweet/describe.

例如：

(GET "/hello" []
  :query-params [name :- (describe String "This is the swagger description for the parameter")]
  (ok {:message (str "Hello, " name)}))