miscellaneous-examples.md

layout	title
page	Miscellaneous Examples

Basic

This example provides a typical minimum you are likely to see in JSON Schema. It contains:

• $id keyword
• $schema keyword
• title annotation keyword
• type instance data model
• properties validation keyword
• Three keys: firstName, lastName and age each with their own:
  • description annotation keyword.
  • type instance data model (see above).
• minimum validation keyword on the age key.

{
  "$id": "https://example.com/person.schema.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Person",
  "type": "object",
  "properties": {
    "firstName": {
      "type": "string",
      "description": "The person's first name."
    },
    "lastName": {
      "type": "string",
      "description": "The person's last name."
    },
    "age": {
      "description": "Age in years which must be equal to or greater than zero.",
      "type": "integer",
      "minimum": 0
    }
  }
}

Data

{
  "firstName": "John",
  "lastName": "Doe",
  "age": 21
}

Describing geographical coordinates.

This example introduces:

• required validation keyword
• minimum validation keyword
• maximum validation keyword

{
  "$id": "https://example.com/geographical-location.schema.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Longitude and Latitude Values",
  "description": "A geographical coordinate.",
  "required": [ "latitude", "longitude" ],
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    }
  }
}

Data

{
  "latitude": 48.858093,
  "longitude": 2.294694
}

Arrays of things

Arrays are fundamental structures in JSON -- here we demonstrate a couple of ways they can be described:

• An array of string values.
• An array of objects.

We also introduce the following with this example:

• definitions keyword
• $ref keyword

{
  "$id": "https://example.com/arrays.schema.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "A representation of a person, company, organization, or place",
  "type": "object",
  "properties": {
    "fruits": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "vegetables": {
      "type": "array",
      "items": { "$ref": "#/definitions/veggie" }
    }
  },
  "definitions": {
    "veggie": {
      "type": "object",
      "required": [ "veggieName", "veggieLike" ],
      "properties": {
        "veggieName": {
          "type": "string",
          "description": "The name of the vegetable."
        },
        "veggieLike": {
          "type": "boolean",
          "description": "Do I like this vegetable?"
        }
      }
    }
  }
}

Data

{
  "fruits": [ "apple", "orange", "pear" ],
  "vegetables": [
    {
      "veggieName": "potato",
      "veggieLike": true
    },
    {
      "veggieName": "broccoli",
      "veggieLike": false
    }
  ]
}