2016-01-18 11 views
6

Was ist äquivalent von Anyof in Swagger Version 2.0, Bitte sagen Sie mir, wie ich meine JSON-Datei aktualisieren, weil ich meine Dokumentation von Swagger 1.0 auf 2.0 aktualisieren möchte.Swagger 2.0 Anyof

Vielen Dank für Ihre Hilfe.

Antwort

4

Ich glaube nicht, dass es einen gibt und es fühlt sich an wie ein großes Manko. Es ist definitiv nicht in the Schema Object portion of the specification erwähnt. Sie nennen es aus den Elementen, die aus dem JSON-Schema und anyOf angenommen wurden, ist nicht unter ihnen:

Die folgenden Eigenschaften direkt aus der JSON-Schema-Definition genommen werden und folgen Sie den gleichen Spezifikationen:

  • $ ref - Als JSON Referenz
  • -Format (siehe Datentyp Formate für weitere Details)
  • Titel
  • Beschreibung (GFM Syntax kann für Rich-Text-Representat verwendet werden Ion)
  • Standard (im Gegensatz zu JSON Schema, muss der Wert der definierten Art für das Schema Object)
  • multipleOf
  • maximale
  • exclusiveMaximum
  • Minimum
  • exclusiveMinimum
  • maxLength
  • konform
  • minLength
  • Muster
  • maxitems
  • minItems
  • uniqueItems
  • maxProperties
  • minProperties
  • erforderlich
  • Enum
  • Typ

die folgenden Eigenschaften aus der JSON-Schema-Definition genommen werden, aber ihre Definitionen wurden an die Swagger-Spezifikation angepasst. Ihre Definition entspricht der aus JSON-Schema. Nur dort, wo die ursprüngliche Definition auf die JSON-Schemadefinition verweist, wird stattdessen die Schemaobjektdefinition verwendet.

  • Artikel
  • allof
  • Eigenschaften
  • additionalProperties

denke ich, die nächste Sache, die discriminator Feld ist, aber das bedeutet, Sie haben Ihre Ausgabe zu strukturieren aufzunehmen Stolzieren.