Swagger UI传参数数组

Swagger UI是一个用于交互式文档化RESTful API的工具，它允许开发者在浏览器中查看、尝试API的请求，并提供详细的响应结果。当你需要在Swagger UI中传递参数数组时，可以按照以下步骤操作：

1. **创建参数**：首先，在Swagger的`paths`部分，找到对应API路径的定义。对于需要参数数组的地方，添加一个`parameters`节点，描述这个数组参数。

{
  "path": "/api/users",
  "post": {
    "tags": ["Users"],
    "summary": "Create a new user",
    "requestBody": {
      "description": "User to create",
      "required": true,
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/User"
          }
        }
      }
    },
    "parameters": [
      {
        "name": "users",
        "in": "body",
        "description": "List of users to create",
        "required": true,
        "schema": {
          "type": "array",
          "items": {"$ref": "#/components/schemas/User"}
        }
      }
    ]
  }
}

这里的`"schema"`部分指定了参数是数组，并且每个元素都是`User`模型的引用。

2. **数据格式**：通常，你需要在`components/schemas`部分定义一个包含数组元素的JSON schema，例如：

{
  "components": {
    "schemas": {
      "User": {
        "type": "object",
        "properties": {
          "id": {"type": "integer"},
          "name": {"type": "string"}
        }
      }
    }
  }
}

3. **提交请求**：在Swagger UI界面上，你可以看到这个参数化的表单，输入你要发送的用户列表（通常是JSON格式），然后点击“Try it out”按钮发送POST请求。