如何用OpenAPISwagger语法描述嵌套的请求主体?

问题描述

我需要使用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"}
    ]
}

解决方法

以下说明可以:

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