SwaggerUI/YAML - 映射条目的缩进错误：无法找到原因

Question

我被 Swagger UI 问题困扰了一个多小时，搜索文档和各种帖子以找到我似乎找不到的解释。

这是我的 YAML 文件的一部分：

paths:
  /projects:
    get:
      tags:
      - projects
      summary: Get projects
      description: 
      operationId: getProjects
      responses:
        200:
          description: successful operation
          schema:
            type: array
            items:
              $ref: "#/definitions/Project"
      security:
      - api_key: []

给我以下内容：

解析器错误：映射条目的缩进错误（第 37 行）

第 37 行是security:。

困扰我的是，在那之后我还出现了相同的“代码”，唯一的变化因素是$ref 的内容，没有在Swagger Editor 中产生任何错误。

Answer 1

1. 路径必须以 / 开头：/projects。

2. description 需要一个值 - 至少是一个空字符串 ""。