Swagger parametre hatası "tam olarak <#/define/parameter> değerinden biri değil"?

Question

Swagger Düzenleyicisi'ni kullanarak basit bir Swagger/Open API tanımı yazmaya çalışıyorum.

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 

aşağıdaki hatayı alıyorum: Ben Swagger şema başvurusu kontrol ettim

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

ve PetStore örnek, ama ben bu alıyorum neden emin değilim. Herhangi bir fikir?

Answer 1

Vücut parametreleri türünü belirtmek için schema anahtar kelime kullanmak, bu yüzden schema altında type, items, minItems ve maxItems taşımanız gerekir.

Ayrıca, type: text, valid type değil. Bunun yerine type: string kullanın.

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