Azure API-management中单个阵列的多个阵列定义

Question

我创建了一个返回数组的项目。导入此swagger.json后，查看swagger.json一切正常。但是，当我从开发人员门户下载API定义时，我看到一些对象，如...Array、...数组-1、...数组-2。我没想到会这样：

​

​

我如何防止这种情况发生？如何才能确保生成的对象与正常对象的行为相同(所以没有虚线，而是点)。我创建了一个重现我的问题的示例项目：https://github.com/mvdiemen/SwaggerArrayGenerationExample。

这是否与此处描述的Azure API管理中的更改有关？：https://blog.tomkerkhove.be/2018/04/13/changes-to-azure-api-management-openapi/

Answer 1

APIM不支持内联架构。尝试仅通过$ref为响应/请求指定模式，即使它是您已经定义的对象数组-定义一个类型为数组的新对象并引用它。

所以，不是像这样：

"200": {
    "description": "Success",
    "schema": {
        "uniqueItems": false,
        "type": "array",
        "items": {
            "$ref": "#/definitions/SwaggerGenerationSample.Models.Response.Employee"
        }
    }
}

在定义中定义数组本身并引用它：

"200": {
    "description": "Success",
    "schema": {
        "$ref": "#/definitions/EmployeeArray"
    }
}
...
"definitions": {
    "EmployeeArray": {
        "uniqueItems": false,
        "type": "array",
        "items": {
            "$ref": "#/definitions/SwaggerGenerationSample.Models.Response.Employee"
        }
    }
}