小编Mik*_*ike的帖子

我正在尝试记录包含各种身份验证是可选的端点的现有 API。也就是说，如果用户获得授权，则返回的数据比未授权时返回的数据多。

无法在 OAspec v3 中明确找到。是否有编码技巧来定义这种情况？

我目前的解决方法是编写授权代码，但在端点的描述中写入授权是可选的。这有效并且似乎足够了。然而，我内心的纯粹主义者想知道是否还有另一种方式。

我正在尝试使用 OpenAPI 规范 (v3) 定义文件下载端点。我面临两个问题。1) 文件没有被下载 2) 在 swagger-ui 中，响应正文显示一条不是由服务器生成的消息（即无法解析 JSON。原始结果：”

任何人都知道我做错了什么？

YAML 代码快照：

在 AWS 服务器上运行的 swagger-ui 的输出结果。

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

[“ string1”，“ string2”，...“ stringN”]

我现在的OpenAPI文档是这样定义的：

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

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