Я пытаюсь построить модель Swagger для временного интервала, используя простую строку для хранения времени (я знаю, что есть также datetime):

definitions:
  Time:
    type: string
    description: Time in 24 hour format "hh:mm".
  TimeInterval:
    type: object
    properties:
      lowerBound:
        $ref: "#/definitions/Time"
        description: Lower bound on the time interval.
        default: "00:00"
      upperBound:
        $ref: "#/definitions/Time"
        description: Upper bound on the time interval.
        default: "24:00"        

По какой-то причине сгенерированный HTML-код не показывает «описание» lowerBound и upperBound, а только оригинальное «описание» времени. Это заставляет меня думать, что я делаю это неправильно.

Так что вопрос в том, можно ли использовать модель как тип на самом деле, как я пытаюсь.