如何表示JSON模式中的總和/聯合類型

Question

我想使用JSON模式來記錄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" } 
    } 
}