以昂首阔步的方式枚举字段名

Question

因此，我在网上进行了一些搜索，并能够找出如何在一个大摇大摆的文档中使用enum标记来指定一个字段的可能值列表。然而，在我当前的API中，我需要的是一个潜在字段列表，每个字段都有一个字符串值。

更准确地说，我有一个在请求正文中发送JSON的POST请求。作为该请求的一部分，用户需要发送单个ID字段。但是，我们接受多种类型的ID字段。因此请求如下所示：

{name：“name”,product：“product”,[FirstIdType,SecondIdType,ThirdIdType]:“id value”}

这是我的大摇大摆的医生的相关信息。需要更改的区域是ID字段。任何关于如何推进的想法或方向都将不胜感激。

definitions:
  request_post:
  description: (post) request schema
  properties:
    name:
      type: string
    product:
      type: string
    Id:
      type: string

Answer 1

您不必定义路径中可以包含哪些可选字段，而是可以标记所需的字段，并在默认情况下设置rest变量。

http://swagger.io/specification/#ParameterObject

required boolean确定此参数是否为强制参数。如果参数位于“path”中，则需要此属性，且其值必须为true。否则，可能包含该属性，其默认值为false。