openapi - 在 Swagger OpenAPI 注解中定义数组

Question

我正在使用带有 OpenAPI 3.0 的 Swagger Editor，并且我安装了 swagger-php 库。现在我有一个 php 函数，其参数之一为数组，例如：

array[(1,2),(2,3),(6,9)]

如何编写此数组的注释以调用此函数。

Answer 1

有不同的解决方案。我建议使用文档中的对象数组来实现它。

arrayOfObjects
    description: 'basic array of objects in OpenAPI'
    type: array
    items:
      type: object
      properties:
        num:
          type: integer

更多信息请在这里找到：

数据类型 - 数组