Я с трудом пытаюсь понять, как я могу вкладывать модели в Swagger 2.0.

В настоящее время у меня есть:

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

OtherModel:
  properties:
    otherProp:
      type: string   

Я пробовал много других способов:

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

Кажется, ничего из вышеперечисленного не работает.

Однако с массивами работает просто отлично:

prop3:
  type: array
  items:
    $ref: OtherModel