如何在SwaggerHub中返回对象数组？

我正在使用OpenAPI2.0在SwaggerHub中定义一个API规范。

/contacts

请求返回一个联系人数组。定义如下：

/联系人：
获取：
标签：
-接触
摘要：获取所有联系人
描述：显示用户的所有联系人。
操作ID:getContact
生产：
-应用程序/json
-应用程序/xml
响应：
200:
说明：操作成功
模式：
$ref:“#/definitions/AllContacts”
400:
描述：提供的id无效
404:
描述：找不到联系人
500:
描述：服务器错误
定义：
所有联系人：
类型：数组
项目：
-$ref:“#/definitions/ContactModel1”
-$ref:“#/definitions/ContactModel2”
ContactModel1：
类型：对象
特性：
身份证件：
类型：整数
示例：1
名字：
类型：字符串
示例：“someValue”
姓氏：
类型：字符串
示例：“someValue”
联系方式2：
类型：对象
特性：
身份证件：
类型：整数
示例：2
名字：
类型：字符串
示例：“someValue1”
姓氏：
类型：字符串
示例：“someValue1”

出于某种原因，它只返回第二个对象，而不是整个对象数组

---

我使用的是OpenAPI 2.0，我怀疑这个版本不支持数组。

对象数组的定义如下。

items

的值必须是描述数组项的单个模型

定义：
所有联系人：
类型：数组
项目：
$ref:“#/definitions/ContactModel”
联系人型号：
类型：对象
特性：
身份证件：
类型：整数
示例：1
名字：
类型：字符串
例如：夏洛克
姓氏：
类型：字符串
例子：福尔摩斯

默认情况下，Swagger UI仅显示一个项目的阵列示例，如下所示：

[
{
“id”：1，
“名字”：“夏洛克”，
“姓氏”：“福尔摩斯”
}
]

如果希望阵列示例包含多个项目，请在阵列模型中指定多个项目

示例

：

定义：
所有联系人：
类型：数组
项目：
$ref:“#/definitions/ContactModel1”
例子：
-身份证号码：1
名字：夏洛克
姓：福尔摩斯
-身份证号码：2
名字：约翰
姓：沃森

是否所有

ContactModel

对象都具有相同的字段名（名称，而不是值）？或者他们有一些不同的字段吗？@Helen他们都有相同的字段名，分别是：id、firstName和lastName。