Я документирую API с помощью документов Swagger. У меня есть несколько конечных точек, которые имеют общий набор базовых свойств. Я хотел бы использовать $ ref для ссылки на этот базовый набор свойств, а затем расширить эти свойства дополнительными свойствами, уникальными для каждой конечной точки. Я предполагал, что это будет работать примерно так, но это неверно:

"properties": {
    "$ref": "#/definitions/baseProperties",
    unique_thing": {
      "type": "string"
    },
    "another_unique_thing": {
      "type": "string"
    }
 }