OpenAPI3和Swagger:如何从一个组件参数的描述引用到另一个组件参数的描述?

OpenAPI3和Swagger:如何从一个组件参数的描述引用到另一个组件参数的描述?,swagger,openapi,Swagger,Openapi,如何从组件的一个描述引用到另一个描述 comparam01: in: query name: comparam01 schema: type: string description: | Any text. comparam02: in: query name: comparam02 schema: # that's working!

如何从组件的一个描述引用到另一个描述

    comparam01:
      in: query
      name: comparam01
      schema:
        type: string
      description: |
        Any text.
    comparam02:
      in: query
      name: comparam02
      schema:
        # that's working!
        $ref: '#/components/parameters/comparam01/schema'
      description: 
        # Swagger says: Error (should be a string)
        $ref: '#/components/parameters/comparam01/description'

你能澄清一下用例吗?您需要两个相同但名称不同的参数吗?是的,我们有两个相同但名称不同的参数。(当然,我们想去掉它。但首先我们需要它作为文档。)中有一个bug,否则它会工作,当您在右侧结果中看到时,它会显示引用的描述
comparim01
,当您在代码中实现它时,它会正常工作,我还检查了nodejs-swagger ui express npm它的工作方式。@turivishal它不是一个bug,因为
description
关键字实际上不支持
$ref
@helen你是对的,检查了swagger规范它只支持字符串类型,你能指导一下,为什么它在代码端工作吗,并且没有给出任何错误或警告,它也显示在编辑器UI端,我在过去的项目中也使用过。你能澄清一下这个用例吗?您需要两个相同但名称不同的参数吗?是的,我们有两个相同但名称不同的参数。(当然,我们想去掉它。但首先我们需要它作为文档。)中有一个bug,否则它会工作,当您在右侧结果中看到时,它会显示引用的描述
comparim01
,当您在代码中实现它时,它会正常工作,我还检查了nodejs-swagger ui express npm它的工作方式。@turivishal它不是一个bug,因为
description
关键字实际上不支持
$ref
@helen你是对的,检查了swagger规范它只支持字符串类型,你能指导一下,为什么它在代码端工作吗,并没有给出任何错误或警告,它也显示在编辑器UI端,我在过去的项目中也使用过。