如何在 Open API 3.0 中为 GET API 定义 Map 对象

Question

我有 GET API，它将 Map 作为请求参数。如何在 Open API 3.0 中以 yaml 格式定义它

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

}

开放API不支持Map类型。

Answer 1

在您的文件中，您需要在 Java 中YAML添加additionalPropertiesfor并使用for as ：Mapparameters@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 如下所示：

我希望它对你有帮助:)