• JSON:
  • A syntax for describing hierarchical data
• A Shortcoming:
  • A document can be syntactically correct but not contain the correct elements

• Impose Structure:
  • For validation, documentation and interaction control
• Syntax:
  • Use JSON

• "title"
  • A string
• "type"
  • "null", "boolean", "object", "array", "number", or "string"
• "required"
  • An array
• "properties"
  • An object
• "items"
  • A schema or array of schemas

A Schema for a Simple Person

jsonexamples/schema/person.jsonschema

{
  "$schema": "http://json-schema.org/schema#",
  "title": "Person",
  "type": "object",
  "required": ["firstName", "lastName", "age"],
  "properties": 
  {
    "firstName":
    {
        "type": "string",
        "description": "Personal name"
    },
    "lastName": 
    {
      "type": "string",
      "description": "Family name"
    },
    "age":
    {
      "type": "number",
      "description": "Age"
    }
  } 
}
        

• For Numbers:
  • maximum, minimum, multipleOf
• For Strings:
  • maxLength, minLength, pattern
• For Arrays:
  • items, maxItems, minItems, uniqueItems, contains
• For Objects:
  • maxProperties, minProperties