Introduction to JSON Schema

What is JSON Schema?

JSON Schema is a vocabulary that allows you to annotate and validate JSON documents. It defines the structure, data types, and constraints of JSON data, making it easier to ensure that JSON data conforms to a specific format.

Benefits of Using JSON Schema

JSON Schema has several benefits, including:

• Provides a formal definition of your JSON data structure
• Enables data validation to ensure data consistency
• Supports the use of data types and constraints for validation
• Provides a clear documentation of JSON data structure

Demos and Playground

Check out some JSON Schema demos and playgrounds to get started!

Demo | Playground

Examples

Title and Description fields:

To add titles and descriptions to the schema, you can modify the schema like this:

 "$schema": "http://json-schema.org/draft-07/schema#",
    "title": "Declaration Schema",
    "description": "Schema for a declaration object containing header, content, and other properties",
    "$ref": "#/definitions/Declaration",
	...

Examples Data:

To add examples to the schema, you can modify the schema like this:

    ...
    "properties": {
        "base64Logo": {
            "type": "string",
            "example": "iVBORw0KGg...",
            "description": "Base64-encoded logo image"
        },
		...

Default Values:

To add default values to the scheme, you can modify the schema like this:

    ...
    "properties": {
        "requiredMessage": {
            "type": "string",
            "default": "This declaration is required",
            "description": "Message to display when declaration is required"
        },
		...

Property descriptions:

To add descriptions to each property in the scheme, you can modify the schema like this:

    ...
    "properties": {
        "base64Logo": {
            "type": "string",
            "description": "Base64-encoded logo image"
        },
        "timestampConfig": {
            "$ref": "#/definitions/TimestampConfiguration",
            "description": "Timestamp configuration object"
        },
        "header": {
            "type": "string",
            "description": "Header of the declaration"
        },
		...

Enumerations

To add enumerations to the schema, you can modify the schema like this:

    ...
    "properties": {
        "preferences": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string",
                        "enum": ["preference1", "preference2", "preference3"],
                        "description": "ID of the preference"
		...

Format

To add format to the schema, you can modify the schema like this:

    ...
    "properties": {
        "signature": {
            "type": "string",
            "format": "base64",
            "description": "Base64-encoded signature image"
        },
        ...
		}
		...

Reference to external documentation:

To add a reference to external documentation, you can use the “$ref” field to link to external documentation, like this:

    ...
    "properties": {
        "signatureOptions": {
            "$ref": "#/definitions/SignatureOptions",
            "description": "Options for the signature"
        },
        ...
    },
    ...

In this case, the “$ref” field is used to link to the signatureOptions definition in the schema itself, but it can also be used to link to external documentation, such as docs.link.com.

By using these fields and best practices, the schema can be made more informative and easier to understand, making it easier for developers to use it and ensuring that the JSON data conforms to the expected format.