如何在openapi中描述可选参数

问题描述

我有一个端点，其中过滤器作为查询参数。我想使过滤器为可选。问题是当我在端点的实现中发送不带任何参数的请求时，我得到一个包含所有空值文件的过滤器对象，而不是filter = null。我尝试向方案添加nullable：true，default：null，required：null并没有成功

/api/v2/bars:
get:
  operationId: getBarsList
  parameters:
    - name: filter
      in: query
      required: false
      schema:
        $ref: '#/components/schemas/Filter'
components:
 schemas:
   Filter:
    type: object
    properties:
      id:
        type: integer
        format: int64
      name:
        maxLength: 30
        minLength: 1
        type: string
    .....

解决方法

暂无找到可以解决该程序问题的有效方法，小编努力寻找整理中！

如果你已经找到好的解决方法，欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@）