Proprietà riferimento a Model on swagger 2.0 (nidificazione)

Question

Sto attraversando un periodo difficile cercando di capire come posso nidificare i modelli in swagger 2.0.

Attualmente ho:

SomeModel: 
properties: 
    prop1: 
    type: string 
    prop2: 
    type: integer 
    prop3: 
    type: 
     $ref: OtherModel 

OtherModel: 
    properties: 
    otherProp: 
     type: string 

Ho provato molti altri modi:

prop3: 
    $ref: OtherModel 
# or 
prop3: 
    schema: 
    $ref: OtherModel 
# or 
prop3: 
    type: 
    schema: 
     $ref: OtherModel 

Nessuno dei precedenti sembra funzionare.

Tuttavia, con gli array funziona bene:

prop3: 
    type: array 
    items: 
    $ref: OtherModel 

Answer 1

Il modo corretto per modellare sarebbe:

SomeModel: 
properties: 
    prop1: 
    type: string 
    prop2: 
    type: integer 
    prop3: 
    $ref: OtherModel 

OtherModel: 
    properties: 
    otherProp: 
     type: string 

Answer 2

credo esempio di Ron dovrebbe leggere:

definitions: 

    OtherModel: 
     properties: 
      otherProp: 
      type: string 

    SomeModel: 
     properties: 
      prop1: 
      type: string 
      prop2: 
      type: integer 
      prop3: 
      type: object 
      $ref: #/definitions/OtherModel 

Answer 3

I l'esempio di Herc dovrebbe essere

definizioni:

OtherModel: 
    properties: 
     otherProp: 
     type: string 

SomeModel: 
    properties: 
     prop1: 
     type: string 
     prop2: 
     type: integer 
     prop3: 
     type: object 
     $ref: '#/definitions/OtherModel'