在 Swagger 中使用 $ref 引用多个文件路径

Question

在记录我的 API 时，如何使用$ref关键字引用多个文件路径？

我目前拥有的是这样的：

paths:
  $ref: "./paths/customers.yaml"

我想要的是：

paths:
  $ref: ["./paths/partner.yaml","./paths/merchants.yaml"]

有出路吗？

Answer 1

$ref 是字符串类型，参见https://swagger.io/specification/

你需要这样做：

paths:
  /partner:
    $ref: "./paths/partner.yaml"
  /merchants  
    $ref: "./paths/merchants.yaml"