yaml - swagger编辑器中的多行文字？

Question

我正在尝试在Swagger编辑器中获得多行文字（顺便说一下，这是一个了不起的工具！）。

  post:
    summary: Translate one or more identifiers
    description: |
Translate one or more identifiers for one entity into the
identifiers of another entity. Translate one or more
identifiers for one entity into the identifiers of another entity.

    consumes:
    - application/json

我尝试过|和>，具有不同的结尾（增加缩进与空行），以及我能想到的所有方式，但始终会产生相同的错误：

YAML Syntax Error
Can not read a block mapping entry; a multiline key may not be an implicit  
key at line 24, column 15: consumes: ^

我看到JS-YAML的错误指示该问题最后是Windows样式的换行符，我知道HTML文本区域可以创建。这是我第一次真正真正使用YAML，所以仅仅是我做错了什么，还是Swagger编辑器中的错误？

Answer 1

我相信问题是您在内容描述块中开始文字的方式。它必须在描述的右边缩进一级：这是一些对我有用的示例：

/{user-id}:
get:
  summary: Facebook User
  description: |
    Displays all information about a Facebook user, depending on access privileges.  Displays all information about a Facebook user, depending on access privileges.
  parameters:
    - name: user-id
      in: path
      description: The Facebook user ID
      required: true
      type: string

在我的实际代码中，描述长三行。