2016-01-18 13 views
6

Qual è l'equivalente di anyof in Swagger versione 2.0, per favore dimmi come aggiornare il mio file json perché voglio aggiornare la mia documentazione da swagger 1.0 a 2.0.Swagger 2.0 Anyof

Grazie per il vostro aiuto.

risposta

4

Non penso che ce ne sia uno e sembra una grande mancanza. Non è sicuramente menzionato in the Schema Object portion of the specification. Lo chiamano gli elementi là che sono stati adottati dal JSON Schema e anyOf non è tra questi:

I seguenti sono presi direttamente dalla definizione JSON Schema e seguono le stesse caratteristiche:

  • $ ref - Come JSON Riferimento
  • formato (vedere i dati Tipo Formati per ulteriori dettagli)
  • titolo
  • descrizione (GFM sintassi può essere utilizzato per ricchi representat text ion)
  • predefinito (differenza JSON Schema, il valore deve essere conforme al tipo definito per l'oggetto dello schema)
  • multipleOf
  • massima
  • exclusiveMaximum
  • minimo
  • exclusiveMinimum
  • maxLength
  • minLunghezza
  • modello
  • MaxItems
  • minItems
  • uniqueItems
  • maxProperties
  • minProperties
  • richiesto
  • enumerazione
  • tipo

Le seguenti proprietà sono tratte dalla definizione JSON Schema ma relative definizioni sono stati adeguati alla specifica Swagger. La loro definizione è uguale a quella di JSON Schema, solo dove la definizione originale fa riferimento alla definizione dello schema JSON, al suo posto viene utilizzata la definizione dell'oggetto Schema.

  • articoli
  • allof
  • proprietà
  • additionalProperties

penso che la cosa più vicina è il campo discriminator, ma questo significa che hai avuto modo di strutturare l'output per accogliere Swagger.

Problemi correlati