OpenAPI 3-覆盖';参数';价值

OpenAPI 3-覆盖';参数';价值,api,swagger,openapi,Api,Swagger,Openapi,我正在构建一个简单的OpenAPI 3 yaml规范,如下所示: . . . /query: get: parameters: - $ref: '#/components/parameters/bookid' components: parameters: bookid: in: query name: bookid required: false schema: format: integer

我正在构建一个简单的OpenAPI 3 yaml规范,如下所示:

. . .
/query:
  get:
    parameters:
    - $ref: '#/components/parameters/bookid'
components:
  parameters:
    bookid:
      in: query
      name: bookid
      required: false
      schema:
        format: integer
        type: number    
现在,我想使用公共
bookid
参数,但将
必需的
值从
false
重写为
true
。例如(那不行!!!):

有办法吗


谢谢。

这不受支持。对于需要的和可选的参数,您需要单独的参数定义。

在一个不相关的注释上,考虑使用<代码>类型:整型< /代码>,而不是<代码>类型:数字< /代码> +>代码>格式:整型< /代码>。但是,创建两个参数?一个
bookid
带有
required:false
,另一个名为
bookid\u required
,与第一个相同,但带有
required:true
?是的,确实如此。这对程序员来说非常糟糕:-/您可以在
. . .
/query2:
  get:
    parameters:
    - $ref: '#/components/parameters/bookid'
      required: true
components:
  parameters:
    bookid:
      in: query
      name: bookid
      required: false
      schema:
        format: integer
        type: number