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

时间:2017-11-29 12:08:17

标签: swagger swagger-ui swagger-2.0 openapi

我已经在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中产生任何错误。

1 个答案:

答案 0 :(得分:3)

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

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