Ring-swagger中的查询参数描述

Question

我正在通过compojure-api使用环形摇杆。我有一些查询参数，我正在努力寻找一种向单个查询参数添加说明的方法。我可以添加整个端点的摘要，但这还不够。

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

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