Java 如何在OpenAPI3.0中为GetAPI定义映射对象

我有一个API，它将Map作为请求参数。如何在OpenAPI3.0中以yaml格式定义它

@GetMapping
public void getDevicesInfo(@RequestParam(required = false) Map parameters)
{

}

---

Open API不支持映射类型。

在您的

YAML

文件中，您需要为Java中的

Map

添加

附加属性

，并为

@RequestParam

使用

参数

，如下所示：

/api/v1/test:
  get:
    tags:
      - test
    operationId: getDevicesInfo
    parameters:
      - name: parameters
        in: query
        required: false
        schema:
          type: object
          additionalProperties:
            type: object
    responses:
      '200':
        description: OK

生成的GET API如下所示：

---

我希望它能帮助您：）

您的意思是要使用什么Java注释（即，如果您从源代码生成API定义），还是字典/地图的OpenAPI YAML语法是什么？