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)}))

ring-swagger中查询参数说明

Query Parameter description in ring-swagger

clojure

swagger

compojure-api