我可以在swagger 2.0中定义嵌套数组对象吗

Question

我们正在使用Swagger 2.0作为我们的留档。我们正在直接从我们的数据设计文档中按语法创建swagger 2.0规范。

我们的模型非常复杂和嵌套。我想了解我们可以定义内联定义的嵌套数组对象吗？

例如：

{
    "definitions": {
        "user": {
            "type": "object",
            "required": ["name"],
            "properties": {
                "name": {
                    "type": "string"
                },
                "address": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string",
                                "enum": ["home",
                                "office"]
                            },
                            "line1": {
                                "type": "string"
                            }
                        },
                        "Person": {
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
} 

在我们的模型中，有很多情况下我们会遇到这种情况，而定义#ref不是我们此时想要考虑的选项。我们需要这个在线处理。

根据以下帖子：https://github.com/swagger-api/swagger-editor/issues/603#even在此处输入代码t-391465196看起来不支持处理内联定义的嵌套数组对象。

由于许多大型企业都有非常复杂的数据模型，我们希望在 swagger 2.0 规范中支持此功能。

有没有想过要添加这个功能。

Answer 1

您的文档只是无效，这与嵌套数组无关：Person属性在项目内的Swagger 2.0架构中是不允许的。

架构中唯一允许的属性包括：$ref、格式、标题、描述、默认值、多个、最大值、最大值、最小值、最小长度、模式、最大项、最小项、唯一项、最大属性、最小属性、必需、枚举、附加属性、类型、项目、全部、属性、鉴别器、只读、xml、外部文档、示例。