Yaml 在swagger API文档中将部分描述切换为内部描述

Yaml 在swagger API文档中将部分描述切换为内部描述,yaml,swagger,documentation,openapi,Yaml,Swagger,Documentation,Openapi,我有一个用swagger编写的API,我想做一些切换,使描述的某个部分成为内部的 parameter: - name: abc description: | line1 line2 line3 在上面的示例中,是否可以引入某种切换,使第3行不会显示在最终文档中。我正在使用openapi-filter.js将对象和属性标记为x-internal,但我不知道如何切换部分描述。openapi中没有一个功能(据我所知,也不是在炫耀)可以隐藏部分描述。我建

我有一个用swagger编写的API,我想做一些切换,使描述的某个部分成为内部的

parameter:
  - name: abc
    description: |
      line1
      line2
      line3

在上面的示例中,是否可以引入某种切换,使第3行不会显示在最终文档中。我正在使用openapi-filter.js将对象和属性标记为x-internal,但我不知道如何切换部分描述。

openapi中没有一个功能(据我所知,也不是在炫耀)可以隐藏部分描述。我建议使用您自己的
x-internal-info
字段或您可以为适当的受众解析的内容。对不起,这不是你希望的答案