paths./crash/{crashId}/.post.parameters[0] 中的架构错误不完全是 <#/definitions/parameter>,<#/definitions/jsonReference>

Question

我正在尝试使用 swagger 编辑器创建我的 API 定义。我查看了 swagger 规范和宠物商店示例，但在创建我的端点之一时我一直收到此错误：

   Schema error at paths./crash/{crashId}/.post.parameters[0]
   is not exactly one from <#/definitions/parameter>,
   <#/definitions/jsonReference>
   Schema error at paths./crash/{crashId}/.post.parameters[1]
   is not exactly one from <#/definitions/parameter>,
   <#/definitions/jsonReference>

这是错误来源的 yaml：

  /crash/{crashId}/:
post:
  tags:
    - crash
  summary: Adds a feedback report
  description: Can add a feedback report with or without a crash
  consumes:
    - application/json
  produces:
    - application/json
  parameters:
    - name: crashId
      in: path
      description: the crash id parameter that this feedback report should 
  connect to
      required: false
      type: integer
      format: int32
    - name: feedbackreport
      in: body
      description: the feedbackreport
      require: true
      schema:
        $ref: '#/definitions/NewFeedbackReport'
  responses:
    '200':
      description: OK

预览仍然可以正常工作，当我把它放在我的 swagger 中时 UI 它看起来就像我想要的那样。

怎么了？我可以忽略这个吗？

Answer 1

1) 路径参数 (in: path) 必须有 required: true，因为它们始终是必需的。

2) body参数中，将require改为required。

paths./crash/{crashId}/.post.parameters[0] 中的架构错误不完全是 <#/definitions/parameter>,<#/definitions/jsonReference>

Schema error at paths./crash/{crashId}/.post.parameters[0] is not exactly one from <#/definitions/parameter>,<#/definitions/jsonReference>

swagger-editor