动态引用
动态引用是 JSON Schema 草案 2020-12 的一项功能,因此包含在 OAS 3.1 中。它允许设置一个占位符引用目标,该目标可以在验证期间根据动态引用的访问方式进行覆盖。如果此解释对您毫无帮助,请不要担心,它归结为两个用例
- 实现泛型类型 (也称为模板化类型),例如容器数据结构或有效负载信封
- 扩展递归模式,因为 OAS 模式需要这样做才能 将 OAS 特定关键字添加到标准 JSON Schema 方言
虽然可能还有其他创造性的方法来使用动态引用,但这些是 API 描述中最有可能出现的情况。