使用 Discriminator

在某些场景中，单个对象可能具有多种结构形式。例如，一本书可以是电子书，也可以是平装书。在这种情况下，可以使用 discriminator 字段来区分不同的 schema 类型。

discriminator 通常与 oneOf 或 anyOf 结合使用，用于表示“某个特定字段的值决定对象的具体类型”。

属性	描述
propertyName	指定用于区分类型的字段名称。
mapping	定义字段值与对应 schema 之间的映射关系。

在 Apidog 中配置

通过可视化界面配置 oneOf

打开 API 的请求或响应编辑器。选择你想要定义为“Schema 组合”字段的字段。点击 高级设置 > Schema 组合 > oneOf，并在 oneOf 中引用你想要组合的 schema，例如 eBook 和 Paperback。

通过 JSON Schema 添加 discriminator

在编辑器中点击 JSON Schema，切换到代码模式。

添加 discriminator 配置，例如：

将 10331225 和 10331226 替换为你实际 schema 的 ID。打开 JSON Schema 配置面板时，你可以看到这些 ID。

验证结果

保存后，Apidog 会根据 type 字段自动识别不同类型。当你发布文档时，API 文档将正确显示区分后的类型。

将定义写入 OpenAPI YAML 或 JSON 文件，例如：

完整定义示例：

然后，在 Apidog 中选择 导入 OpenAPI 文件。

导入后，Apidog 会自动识别 discriminator，并在 schema 和端点定义中正确映射类型。当你发布文档时，API 文档将正确显示区分后的类型。