嵌套数组的 OpenAPI 规范

Question

我正在 Swagger 中为其中一个 API 编写 OpenAPI 规范，其输出是另一个数组中的嵌套数组。以下是相同的示例。

有人可以指导我如何描述此类 API 响应的输出部分吗？

{
    "version": "1.0",
    "calculatedDateTime": "20230320 134724",
    "brand": [
        {
            "brandCode": "RET",
            "market": [
                {
                    "ValueCode1": "ABC",
                    "ValueCode2": "A192",
                    "product": [
                        {
                            "ProductFeat1": "A9",
                            "ProductFeat2": "100CD",
                            "ProductFeat3": "3",
                            "ProductFeat4": "20230313 000000",
                            "ProductFeat5": "cert"
                        }
                    ],
                    "market_units": {
                        "UnitCategory1": "g/km",
                        "UnitCategory2": 0,
                        "UnitCategory3": "l/100km",
                        "UnitCategory4": "Wh/km"
                    }
                },
               {
                    "ValueCode1": "ORT",
                    "ValueCode2": "ORT",
                    "product": [
                        {
                            "ProductFeat1": "B10",
                            "ProductFeat2": "100CL",
                            "ProductFeat3": "5",
                            "ProductFeat4": "20230314 000000",
                            "ProductFeat5": "cert"
                        },
                        {
                            "ProductFeat1": "H3",
                            "ProductFeat2": "100C8",
                            "ProductFeat3": "2",
                            "ProductFeat4": "20230213 000000",
                            "ProductFeat5": "non_cert"
                        }
                    ],
                    "market_units": {
                        "UnitCategory1": "g/km",
                        "UnitCategory2": 0,
                        "UnitCategory3": "l/100km",
                        "UnitCategory4": "Wh/km"
                    }
                }
            ]
        }
    ],
    "legal_units": {
        "LegalUnitCategory1": "g/km",
        "LegalUnitCategory2": "l/100km",
        "LegalUnitCategory3": "Wh/km",
        "LegalUnitCategory4": "km",
        "LegalUnitCategory5": "kg",
        "LegalUnitCategory6": "N"
    }
}

我尝试为 legal_units 和 market_units 对象创建一个数组，然后尝试在输出中引用它们，但无法根据确切的输出对齐它们。