如何用OpenAPI（Swagger）语法描述嵌套的请求体？

Question

我需要使用 OpenAPI (Swagger) 语法来描述 REST (JSON) API。我陷入了我需要描述嵌套请求主体的阶段。请建议如何制作，让我们使用下一个嵌套请求正文作为示例：

{
   "pauses" : [
     {"name" : "PAUSING_AUTO"},
     {"name" : "NO_PAUSE_CRITERIA","Min" : 15},
     {"name" : "PREVENTED_PAUSE","Min" : 5},
     {"name" : "REVERT_TO_RUN"},
     {"name" : "RUNNING"}
    ]
}

Answer 1

以下描述即可：

pauses:
    type: "array"
    items:
      type: "object"
      required: 
        - name
      properties:
        name:
          type: "string"
        Min:
          type: "integer"