json-schema中的自由格式子对象

Question

我正在用swagger.io起草一个API文档，并试图使其适合我们的用例。系统将接收和处理来自所有来源的数据，每个来源都有不同的字段集。

虽然处理的产品共享相同的模式，但我们也希望在模式中包含输入以供参考。例如，给定

{
    "foo": "bar"
    "bar": "baz"
}

{
    "original": {
        "foo": "bar",
        "bar": "baz"
    }
    "processed": {
        "stdFieldA": "bar",
        "stdFieldB": "baz"
    }
}

假设对于来自不同来源的每个输入，我们最终都有stdfielda和stdfieldb。所以我们的响应模式对象

type: object
properties:
    processed:
        type: object
        properties:
            stdFieldA:
                type: string
            stdFieldB:
                type: string

既然我们已经定义了处理子对象，那么我们是否可以为原始输入定义一个自由格式的对象，以便来自另一个源的对象是有效的

{
    "alpha": "lorem",
    "beta": "ipsum"
}

如果我没有得到任何答案，我的解决方法是将原始输入存储为字符串（将原始输入转换为JSON字符串）。

Answer 1

类型：对象没有属性描述自由格式对象。因此响应模式可以是：

type: object
properties:
    original:
        type: object    # <----------
    processed:
        type: object
        properties:
            stdFieldA:
                type: string
            stdFieldB:
                type: string