问题描述
在引用外部组件时,如何动态设置“ $ ref”中的http url作为URL引用以及特定于swagger yaml文件的环境?
Address:
$ref: 'https://HOST:PORT/api/model/v1/components.yaml#/components/schemas/Address'
在上面的url中,我想从属性文件或某些外部源中为每个环境选择HOST:PORT。
推荐的招摇博士: https://swagger.io/docs/specification/using-ref/
解决方法
在记录API时,通常会在一些API资源中使用某些功能。在这种情况下,您可以为此类元素创建一个片段,以便在需要时多次使用它们。使用OpenAPI 3.0,您可以引用托管在任何位置的定义。它可以是同一台服务器,也可以是另一台服务器,例如GitHub,SwaggerHub等。要引用定义,请使用$ ref关键字: $ ref:“对定义的引用”