Swagger 编辑器导入规范和外部参考

Question

我正在使用 swagger 编辑器，并已将 openapi 规范作为 yaml 导入，但由于所有外部引用，它显示错误

- $ref: '#/components/parameters/orgIdPathParam'

指向另一个文件中的定义

  parameters:
    orgIdPathParam:
      $ref: 'api-resources-params.yaml#/orgIdPathParam'

这是许多相同错误之一：

Declared path parameter "org_id" needs to be defined as a path parameter at either the path or operation level
Jump to line 33

我可以使用验证器徽章工具进行验证（https://github.com/swagger-api/validator-badge），所以我知道它是有效的。所以看来 swagger 编辑器没有考虑外部定义的参数。如何通过 yaml 将外部定义的参数放入 swagger 编辑器中？我不想启动服务器并传递 url 只是为了修改 openapi 规范，只想直接导入和编辑。

Answer 1

如果您在路由中使用 Id，则需要在放置该路由的方法之前在下面声明该 ID。我将在下面举一个例子。