如何描述开放式API规范中必须包含的多列之一?

时间:2018-12-14 08:55:02

标签: swagger swagger-2.0

示例:我正在对书籍模型进行批量更新,其中包含以下内容 属性ID,名称,标题 如果我发送的名称或书名中至少有2本书(或更多)中的一个,则我的请求有效。

至少可以说一本书的名字或标题是必填项。

有效的请求正文如下所述

请求1:

{
  "books": [
    {
      "id": 1,
      "name": "abc"
    },
    {
      "id": 2
    }
  ]
}

请求2:

{
  "books": [
    {
      "id": 1 ,
      "title": "abc"
    },
    {
      "id": 2
    }
  ]
}

但低于1则无效,并返回必填参数缺失错误

请求3:

{
  "books": [
    {
      "id": 1
    },
    {
      "id": 2
    }
  ]
}

我该如何在合同文件中提及这些参数,因为其中之一是本书中的全部而不是全部的必需内容。

0 个答案:

没有答案