Swagger參數錯誤“不是<＃/ definitions / parameter>中的一個”？

Question

我正在嘗試使用Swagger編輯器編寫一個簡單的Swagger / Open API定義。

swagger: "2.0"

info:
  version: 1.0.0
  title: Test API
  description: Test API

schemes:
  - https
host: hipaa.ai
basePath: /v1

paths:
  /comments:
    post:
      summary: Your comments
      description: Comments
      parameters:
      - name: text
        in: body
        description: An array of text strings
        type: array
        minItems: 1
        maxItems: 1000
        items:
          type: text

我收到以下錯誤：

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

我已經檢查了Swagger架構參考和petstore示例，但我不知道為什么我會得到這個。 有任何想法嗎？

Answer 1

Body參數使用schema關鍵字指定類型，因此您需要在schema下移動type ， items ， minItems和maxItems 。

另外， type: text不是有效類型 。 請改用type: string 。

      parameters:
      - name: text
        in: body
        description: An array of text strings
        schema:
          type: array
          minItems: 1
          maxItems: 1000
          items:
            type: string