To require at least one of a set of properties, use required inside a series of anyOf options: { “type”: “object”, “anyOf”: [ {“required”: [“id”]}, {“required”: [“email”]} // any other properties, in a similar way ], “properties”: { // Your actual property definitions here } } If any of the properties you want is present … Read more
[author of the draft v4 validation spec here] You have stumbled upon the most common problem in JSON Schema, that is, its fundamental inability to do inheritance as users expect; but at the same time it is one of its core features. When you do: “allOf”: [ { “schema1”: “here” }, { “schema2”: “here” } … Read more
Visual Studio 2017 has this feature. From the menu, choose Edit, Paste Special, Paste JSON As Classes. Paste in the JSON and Visual Studio will create the required classes.
Disclaimer: I am the author of Jsonix, a powerful open-source XML<->JSON JavaScript mapping library. Today I’ve released the new version of the Jsonix Schema Compiler, with the new JSON Schema generation feature. Let’s take the Purchase Order schema for example. Here’s a fragment: <xsd:element name=”purchaseOrder” type=”PurchaseOrderType”/> <xsd:complexType name=”PurchaseOrderType”> <xsd:sequence> <xsd:element name=”shipTo” type=”USAddress”/> <xsd:element name=”billTo” type=”USAddress”/> … Read more
After longer fight with using Swagger for specifying REST API and reusing it in related test suites, I will share my own experience with it (answering my own question). Swagger supports only subset of JSON Schema Draft 4 Specification of Swagger 1.2 and 2.0 states, it supports only subset of JSON Schema Draft 4 (s. … Read more
There’s no built-in type for UUID, but the OpenAPI Specification suggests using type: string format: uuid From the Data Types section (emphasis mine): Primitives have an optional modifier property: format. OAS uses several known formats to define in fine detail the data type being used. However, to support documentation needs, the format property is an … Read more
The problem is the “not” semantics. “not required” does not mean “inclusion forbidden”. It just means that you don’t have to add it in order to validate that schema. However, you can use “oneOf” to satisfy your specification in a simpler way. Remember that it means that “just one of these schemas can validate”. The … Read more
I believe what you need to do to achieve this is set additionalProperties to false. See the specification here
From Gary Court: I personally use .schema.json, but there is no official file extension. The official mime type however is “application/schema+json”.
Option A is correct and satisfy your requirements. { “type”: “array”, “items”: { “type”: “string”, “enum”: [“one”, “two”, “three”] } }