自动替换 JSON swagger 中的数据模型引用

Question

是否有简单的方法将 swagger json 文件中的所有

"$ref":

替换为位于

"components":

中文件末尾的模型？当然，它可以是对另一个参考的另一个参考，等等。 swagger配置有什么选项吗？

例如。之前：

"schema": {
"$ref": "#/components/schemas/ModelName"
}

之后：

"schema": {
"ModelName": {
"type": "object",
"properties": {
"type": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"nullable": true
},
"status": {
"type": "integer",
"format": "int32",
"nullable": true
},
"detail": {
"type": "string",
"nullable": true
},
"instance": {
"type": "string",
"nullable": true
}
},
"additionalProperties": { }
}
}

Answer 1

您可以使用 www.redocly.com

bundle

功能轻松做到这一点

npx @redocly/cli bundle <api file> --output <where to save> --format json