draft-feature

alternativeSchema - x-oas-draft-alternativeSchema

媒体类型对象

固定字段
字段名称 类型 描述
alternativeSchemas [备选模式对象] 备选模式列表。除了任何现有的 schema 属性之外,还可以使用这些模式作为替代。如果同时存在 OAS 模式和备选模式,则应同时遵守 OAS 模式和其中一个备选模式。必须按顺序处理备选模式。对于工具来说,为了将内容视为有效,只需处理它们能够处理的第一个备选模式就足够了。如果工具无法处理任何备选模式,则可以发出警告,但不得报告 OpenAPI 描述无效。

备选模式对象

此对象使您可以引用包含不遵循 OAS 规范的模式的外部文件。

固定字段
字段名称 类型 描述
type 字符串 必填。该值必须与备选模式注册中心标签名称中标识的值之一匹配。
externalValue URL 必填。这是对包含已知类型模式的外部文件的绝对或相对引用。

此对象可以使用 规范扩展 进行扩展。