Swagger.io - Array von Referenzen in Post-Methode

Question

Ich habe eine Frage darüber, wie ein Array von Referenzen in Swagger mit der Yaml-Syntax zu definieren. Ich habe folgendes yaml Schnipsel, die mein Feld definiert:

- name: myfield 
     in: formData 
     description: 'description' 
     required: false 
     type: array 
     items: 
     $ref: '#/definitions/MyRef' 

Die Definition ist die folgende:

MyRef: 
    type: object 
    properties: 
     id: 
     type: integer 
     value: 
     type: string 
     description: the value for the myRef 

In der Vorschau auf meinem Feld alles sieht gut aus:

Aber ich habe den Fehler "Keine gültige Parameterdefinition" erhalten und im Detailfehler habe ich "Daten stimmt mit keinem Schema von 'oneOf'" überein.

Ich kann nichts dergleichen in der Dokumentation finden. Also, was ist die richtige Struktur oder was fehlt mir?

Answer 1

das ist, weil formData kann nur Primitive oder Arrays von Primitiven enthalten. Sie können $ref nicht als items-Wert verwenden. Dies wird in der nächsten Version der Spezifikation (3.0) geändert, wird aber in den 2.0-Werkzeugen nicht unterstützt, da die Spezifikation dies nicht erlaubt.