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端,我在过去的项目中也使用过。