Rest 如何在swagger中更改查询参数名称？

我正在尝试获取此url:

https://search.me/Search/api/search?map=%7B%22query%22:%22CSCI+250%22、%22行%22:500、%22学期%22:%222181%22、%22职业%22:%22%22、%7D

如果不将特殊字符转换为十六进制，则URL将为：

https://search.me/Search/api/search?map={查询：CSCI-250，行数：500，术语：2181，职业：}

我知道在OpenAPI3.0.0中不可能将特殊字符序列化为十六进制，所以我可以在查询参数中使用完整的JSON

其中参数是JSON->URI JSON是：

{
  map:  {
    "query": "CSCI 250",
    "rows": 500,
    "term": 2181,
    "career": ""
  }
}

但是，昂首阔步反而表现为：

https://search.me/search/api/search?query=CSCI-250&rows=500&term=2181&career=

如您所见，特殊字符随后被转换为十六进制

下面是我的路径。我到底做错了什么

paths:
  /search:
    get:
      summary: Search
      parameters:
      - in: query
        name: map
        description: JSON for lookup
        required: true
        schema:
            $ref: '#/components/schemas/QueryParams'
      responses:
        200:
          description: Course search response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/QueryResults'
        400:
          description: Bad request

---

预期示例

../map？=CSCI-250

正确吗？它在

？

后面直接有

=

，因此第一个参数名似乎丢失了。我添加了所需的正确URL@HelenI不介意不转换为十六进制，因为我记录了这一点，我只想显示正确的参数名。应该是

map

而不是

query

可能与OpenAPI 3.0的is重复。