使用 OpenAPI v3 规范定义一个或多个字符串数组的正确方法

Question

我希望 POST 一个包含可变数量字符串的数组，例如

["string1", "string2", ... "stringN"]

我目前的 OpenAPI 文档是这样定义的：

schema:
  type: array
    items:
      description: networkIds
      type: string

这是按照 OpenAPI v3 规范编写代码的正确方法，还是有更精确的方法来指示数组中的一个或多个字符串？

Answer 1

缩进错误 – type 和 items 必须在同一级别。

如果数组不能为空且始终至少有 1 个项目，您可以添加 minItems: 1 作为附加约束。如果所有项目都必须是唯一的，请添加 uniqueItems: true.

schema:
  type: array
  items:
    description: networkIds
    type: string
  minItems: 1

Correct way to define an array of one or more strings using the OpenAPI v3 Specification