Ich dokumentiere eine API mit Swagger-Dokumenten. Ich habe mehrere Endpunkte, die einen gemeinsamen Satz von Basiseigenschaften haben. Ich möchte $ ref verwenden, um auf diesen Basissatz von Eigenschaften zu verweisen, und dann diese Eigenschaften mit zusätzlichen Eigenschaften erweitern, die für jeden Endpunkt eindeutig sind. Ich stellte mir vor, es würde so etwas funktionieren, aber das ist ungültig:

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