招摇编辑器 - 其他属性错误

Question

我刚刚开始使用Swagger Editor/OpenAPI 3规范，所以到目前为止还不太好。我已经在本地机器上安装并运行了Swagger Editor v.3.15.2。

这是我到目前为止的yaml：

openapi: "3.0.0"
info:
  version: 1.0.0
  title: Test
paths:
  /object:
    post:
      summary: Create an object
      operationId: createObject
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/Object"
    responses:
      '201':
        description: Created
components:
  schemas:
    Object:
      required:
        - name
        - description
      properties:
        name:
          type: string
        description:
          type: string

它显示了这个错误：

Errors


Resolver error
e is undefined
Structural error at paths./object
should NOT have additional properties
additionalProperty: responses
Jump to line 6
Structural error at paths./object.post
should have required property 'responses'
missingProperty: responses
Jump to line 7

我已经确保我对所有缩进使用两个空格。当我从编辑器复制yaml并将其放入记事本时，它看起来很好。我还将其粘贴到另一个编辑器中，注意到它只使用换行符而不是回车。我更新了它以使用两者，但仍然得到相同的错误。

我已经看了其他有同样问题的问题，但是没有一个解决方案对我有效。所以，不确定我做错了什么。任何指导都是非常感谢的。

Answer 1

您有一个小缩进问题。

将一个缩进级别添加到

responses:
  '201':
    description: Created

这样，您就可以：

openapi: "3.0.0"
info:
  version: 1.0.0
  title: Test
paths:
  /object:
    post:
      summary: Create an object
      operationId: createObject
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/Object"
      responses:
        '201':
          description: Created
components:
  schemas:
    Object:
      required:
        - name
        - description
      properties:
        name:
          type: string
        description:
          type: string