在 Swagger 中,可以使用 $ref 关键字来引用其他文件中的定义。具体步骤如下:

  1. 创建一个主文件,例如 swagger.yaml,其中包含所有 API 定义。

  2. 在主文件中,使用 $ref 引用其他文件中的定义。例如,假设有一个名为 definitions.yaml 的文件,其中包含一些共用的模型定义,可以在主文件中使用以下代码引用:

definitions:
  User:
    $ref: 'definitions.yaml#/definitions/User'
  1. 如果有多个文件需要引用,可以使用相对或绝对路径来引用文件。例如,如果 definitions.yamlparameters.yaml 文件都在同一个目录下,可以使用以下代码引用:
$ref: './definitions.yaml#/definitions/User'
$ref: './parameters.yaml#/parameters/limit'
  1. 在使用多个文件时,需要确保文件路径和文件名的大小写和拼写正确,否则会导致无法解析引用。

总的来说,使用多个文件可以更好地组织 Swagger 定义,使其更易于管理和维护。


原文地址: https://www.cveoy.top/t/topic/sBU 著作权归作者所有。请勿转载和采集!

免费AI点我,无需注册和登录