Swagger 标记$ref don';不显示openapi3.0的内容

Swagger 标记$ref don';不显示openapi3.0的内容,swagger,openapi,api-doc,Swagger,Openapi,Api Doc,我有一段api规范,其中包含关于外部文件中的内容: paths: /about: $ref: ./api/about.yml#/about 这样,当我使用创建捆绑包时,about内容不会加载。但是,如果我增加一个辅助标记,则内容将被加载 paths: /about: whatever: $ref: ./api/about.yml#/about 使用which标记,Swagger编辑器显示一个结构错误,但如果没有她,则不会加载。一些提示 Obs:我已经在op

我有一段api规范,其中包含关于外部文件中的内容:

paths:
  /about:
    $ref: ./api/about.yml#/about
这样,当我使用创建捆绑包时,
about
内容不会加载。但是,如果我增加一个辅助标记,则内容将被加载

paths:
  /about:
    whatever:
      $ref: ./api/about.yml#/about
使用
which
标记,Swagger编辑器显示一个结构错误,但如果没有她,则不会加载。一些提示


Obs:我已经在openapi 3.0中的
$ref
标记中看到了一些错误。

关于.yml的
的内容是什么?
关于:get:tags:-关于摘要:get\u关于操作id:get\u关于参数:-名称:中的授权:头描述:''Authorization''头,值为''Bearer''''必需:true模式:类型:字符串默认值:承载响应:403:描述:客户未授权内容:{}组件:securitySchemes:BeareAuth:type:http方案:承载BearePerformat:JWT