使用 Discriminator

在某些情境中，單一物件可能具有多種結構形式。例如，一本書可以是電子書，也可以是平裝書。在這種情況下，可以使用 discriminator 欄位來區分不同的 schema 類型。

discriminator 通常會搭配 oneOf 或 anyOf 使用，用來表示「特定欄位的值決定了物件的具體類型」。

屬性	說明
propertyName	指定用於區分類型的欄位名稱。
mapping	定義欄位值與對應 schema 之間的映射關係。

在 Apidog 中設定

方法 1：使用 JSON Schema

透過視覺化介面設定 oneOf

開啟 API 的請求或回應編輯器。選取你想要定義為「Schema Composition」欄位的欄位。點擊 Advanced Settings > Schema Composition > oneOf，並在 oneOf 中引用你想要組合的 schema，例如 eBook 和 Paperback。