JSON Schema vs. OpenAPI v3 vs. OpenAPI v2

	A	B	C	D	E	F	G	H	I	J	K	L	M
1		JSON Schema draft 4		go-openapi/validate (Aug 1)		OpenAPI v3		OpenAPI v2		CRDs v3		CRDs v2
2	title	yes		yes		yes		yes		yes		as v3
3	multipleOf	yes		yes		yes		yes		yes		as v3
4	maximum	yes		yes		yes		yes		yes		as v3
5	exclusiveMaximum	yes		yes		yes		yes		yes		as v3
6	minimum	yes		yes		yes		yes		yes		as v3
7	exclusiveMinimum	yes		yes		yes		yes		yes		as v3
8	maxLength	yes		yes		yes		yes		yes		as v3
9	minLength	yes		yes		yes		yes		yes		as v3
10	pattern	yes	ECMA 262	yes		yes	ECMA 262	yes	ECMA 262	yes		as v3
11	maxItems	yes		yes		yes		yes		yes		as v3
12	minItems	yes		yes		yes		yes		yes		as v3
13	uniqueItems	yes		yes		yes		yes		yes		as v3
14	maxProperties	yes		yes		yes		yes		yes		as v3
15	minProperties	yes		yes		yes		yes		yes		as v3
16	required	yes		yes		yes		yes		yes		as v3
17	enum	yes		yes		yes		yes		yes		as v3
18	allOf	yes		yes		yes		yes		yes		as v3
19	oneOf	yes		yes		yes		no		yes		no field
20	anyOf	yes		yes		yes		no		yes		no field	this one hurts a lot
21	not	yes		yes		yes		no		yes		no field
22	items	yes	can be an array	yes	can be an array	partially	MUST be an object and not an array	yes	can be an array	partially	no array	as v3
23	properties	yes		yes		yes		yes		yes		as v3
24	additionalProperties	yes		yes		yes		yes		yes		as v3
25	description	yes		yes		yes	rich text representation possible	yes	rich text representation possible	yes		as v3
26	format	yes		yes		extended		extended		extended	see below	as v3
27	default	yes	must match type	yes		yes	must match type	yes	must match type	no field	no field for now, until we support defaulting	as v3
28	patternProperties	yes		yes		no		no		no field		as v3
29	type	yes		yes		partially	string only	partially	string only	partially	string only	as v3
30	$ref	yes		yes		yes		yes		yes		as v3
31	id	yes		yes		no		no		no field		as v3
32	$schema	yes		yes		no		no			only in root element	as v3
33	dependencies	yes		yes		no		no		no field		as v3
34	definitions	yes		yes		no		no		no field		as v3
35	additionalItems	yes		yes		no		no		no field		as v3
36
37
38	nullable	no		no		yes		no		no field		as v3
39	discriminator	no		yes		yes		yes		no field		as v3
40	readOnly	no		yes		yes		yes		no field		as v3
41	writeOnly	no		no		yes		no		no field		as v3
42	xml	no		yes		yes		yes		no field		as v3
43	externalDocs	no		yes		yes		yes		yes		as v3
44	example	no		yes		yes		yes		yes		as v3
45	deprecated	no		no		yes		no		no field		as v3
46
47	type integer	yes		yes		yes		yes		yes		as v3
48	type number	yes		yes		yes		yes		yes		as v3
49	type string	yes		yes		yes		yes		yes		as v3
50	type boolean	yes		yes		yes		yes		yes		as v3
51	type array	yes		yes		yes		yes		yes		as v3
52	type null	yes		yes		no		no		reject		as v3
53	type object	yes		yes		yes		yes		yes		as v3
54
55
56
57	format int32	no		yes		yes		yes		yes		as v3
58	format int64	no		yes		yes		yes		yes		as v3
59	format float	no		yes		yes		yes		yes		as v3
60	format double	no		yes		yes		yes		yes		as v3
61	format byte	no		yes		yes		yes		yes		as v3
62	format binary	no		yes		yes		yes		yes		as v3
63	format date	no		yes		yes		yes		yes		as v3
64	format date-time	yes		yes		yes		yes		yes		as v3
65	format password	no		yes		yes		yes		yes		as v3
66	format email	yes		yes		partially	allowed, but not specified	partially	allowed, but not specified	yes		as v3
67	format hostname	yes		yes		partially	allowed, but not specified	partially	allowed, but not specified	yes		as v3
68	format ipv4	yes		yes		partially	allowed, but not specified	partially	allowed, but not specified	yes		as v3
69	format ipv6	yes		yes		partially	allowed, but not specified	partially	allowed, but not specified	yes		as v3
70	format uri	yes		yes		partially	allowed, but not specified	partially	allowed, but not specified	yes		as v3
71	format uri-reference	yes		no		partially	allowed, but not specified	partially	allowed, but not specified	no		as v3
72	format uri-template	yes		no		partially	allowed, but not specified	partially	allowed, but not specified	no		as v3
73	format json-pointer	yes		no		partially	allowed, but not specified	partially	allowed, but not specified	no		as v3
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100