如何在json模式中表示sum/union类型

Question

我试图使用json-schema记录JSON的现有用法.系统允许其中一个对象属性具有以下两种可能性.

或

{
    "tracking_number" : 123
}

要么

{
    "tracking_number" : [ 123, 124, 125 ]
}

如何使用json架构表达这一点？

Answer 1

使用anyOf断言,属性必须符合一个或另一个模式.

{
    "type": "object",
    "properties": {
        "tracking_number": {
            "anyOf": [
                { "$ref": "#/definitions/tracking_number" },
                { "type": "array", "items": { "$ref": "#/definitions/tracking_number" }
            ]
    },
    "definitions": {
        "tracking_number": { "type": "integer" }
    }
}