Riferimento JSON Schema Riferimento Parole Chiave

38 parole chiave

$schemaCore / MetaSi applica a: root

Declares the JSON Schema dialect version

{ "$schema": "https://json-schema.org/draft/2020-12/schema" }

ℹ Always include at root to declare the dialect

$idCore / MetaSi applica a: any

Sets the base URI for the schema

{ "$id": "https://example.com/schemas/user.json" }

titleCore / MetaSi applica a: any

Human-readable title for the schema or property

{ "title": "User", "type": "object" }

descriptionCore / MetaSi applica a: any

Human-readable description of the schema's purpose

{ "description": "A registered user account", "type": "object" }

$commentCore / MetaSi applica a: any

Developer comment — not rendered to users

{ "$comment": "Added 2024-01 to support OAuth users" }

$defs / definitionsCore / MetaSi applica a: root

Repository for reusable sub-schemas

{ "$defs": { "email": { "type": "string", "format": "email" } } }

ℹ $defs is draft 2020-12+; use definitions in draft-07

$refCore / MetaSi applica a: any

Reference to another schema by URI or JSON Pointer

{ "$ref": "#/$defs/email" }

ℹ Can reference internal (#/$defs/…) or external schemas

type: stringTypesSi applica a: string

Value must be a JSON string

{ "type": "string" }

type: numberTypesSi applica a: number

Value must be a JSON number (integer or float)

{ "type": "number" }

type: integerTypesSi applica a: number

Value must be a whole number (no fractional part)

{ "type": "integer" }

type: booleanTypesSi applica a: boolean

Value must be true or false

{ "type": "boolean" }

type: nullTypesSi applica a: null

Value must be JSON null

{ "type": "null" }

type: arrayTypesSi applica a: array

Value must be a JSON array

{ "type": "array" }

type: objectTypesSi applica a: object

Value must be a JSON object

{ "type": "object" }

type: [multiple]TypesSi applica a: any

Value may be one of the listed types

{ "type": ["string", "null"] }

ℹ Useful for optional/nullable fields

minLength / maxLengthStringsSi applica a: string

Minimum and maximum number of Unicode code points

{ "type": "string", "minLength": 1, "maxLength": 100 }

patternStringsSi applica a: string

Value must match a ECMA 262 regular expression

{ "type": "string", "pattern": "^[a-z0-9_]+$" }

ℹ Partial match — use ^ and $ to anchor

formatStringsSi applica a: string

Semantic validation hint (implementation-dependent)

{ "type": "string", "format": "email" }

ℹ Common values: email, uri, uuid, date, date-time, ipv4, ipv6, hostname

enumStringsSi applica a: any

Value must be one of the listed values

{ "type": "string", "enum": ["active", "inactive", "pending"] }

constStringsSi applica a: any

Value must exactly equal the given value

{ "const": "v1" }

ℹ Equivalent to enum with a single value

minimum / maximumNumbersSi applica a: number

Inclusive lower and upper bounds

{ "type": "number", "minimum": 0, "maximum": 100 }

exclusiveMinimum / exclusiveMaximumNumbersSi applica a: number

Exclusive lower and upper bounds (value < max, value > min)

{ "type": "number", "exclusiveMinimum": 0 }

ℹ In draft-07 these were booleans; draft 2019+ they are numbers

multipleOfNumbersSi applica a: number

Value must be a multiple of the given number

{ "type": "integer", "multipleOf": 5 }

propertiesObjectsSi applica a: object

Schema for each named property

{ "type": "object", "properties": { "name": { "type": "string" }, "age": { "type": "integer" } } }

requiredObjectsSi applica a: object

Array of property names that must be present

{ "type": "object", "required": ["id", "email"] }

additionalPropertiesObjectsSi applica a: object

Schema or boolean controlling unknown properties

{ "type": "object", "additionalProperties": false }

ℹ false = no extra properties allowed; a schema validates extra properties

patternPropertiesObjectsSi applica a: object

Schemas applied to properties whose name matches the regex key

{ "patternProperties": { "^S_": { "type": "string" } } }

minProperties / maxPropertiesObjectsSi applica a: object

Min/max number of properties in the object

{ "type": "object", "minProperties": 1, "maxProperties": 10 }

items (draft-07)ArraysSi applica a: array

Schema for all items (or tuple schemas as array)

{ "type": "array", "items": { "type": "string" } }

ℹ In draft-2020-12, items applies to all remaining items after prefixItems

prefixItems (2020-12)ArraysSi applica a: array

Per-index schemas for a tuple

{ "type": "array", "prefixItems": [{ "type": "string" }, { "type": "number" }] }

ℹ Replaces tuple form of items from draft-07

minItems / maxItemsArraysSi applica a: array

Min/max number of array elements

{ "type": "array", "minItems": 1, "maxItems": 50 }

uniqueItemsArraysSi applica a: array

All items must be unique

{ "type": "array", "items": { "type": "string" }, "uniqueItems": true }

containsArraysSi applica a: array

At least one item must match the given schema

{ "type": "array", "contains": { "const": "admin" } }

ℹ Use minContains / maxContains to control how many must match

allOfCompositionSi applica a: any

Value must be valid against ALL listed schemas

{ "allOf": [{ "type": "string" }, { "minLength": 5 }] }

ℹ Intersection — use for schema composition/extension

anyOfCompositionSi applica a: any

Value must be valid against AT LEAST ONE listed schema

{ "anyOf": [{ "type": "string" }, { "type": "number" }] }

oneOfCompositionSi applica a: any

Value must be valid against EXACTLY ONE listed schema

{ "oneOf": [{ "type": "string" }, { "type": "number" }] }

ℹ Validates all and ensures exactly one matches — slower than anyOf

notCompositionSi applica a: any

Value must NOT be valid against the given schema

{ "not": { "type": "null" } }

if / then / elseCompositionSi applica a: any

Conditional validation: if condition matches, then/else applies

{ "if": { "properties": { "type": { "const": "email" } } }, "then": { "required": ["email"] }, "else": { "required": ["phone"] } }

Esempio di Schema Completo

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://example.com/schemas/user.json",
  "title": "User",
  "description": "A registered user account",
  "type": "object",
  "required": ["id", "email", "role"],
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 255
    },
    "name": {
      "type": ["string", "null"],
      "maxLength": 100
    },
    "role": {
      "type": "string",
      "enum": ["admin", "editor", "viewer"]
    },
    "tags": {
      "type": "array",
      "items": { "type": "string" },
      "uniqueItems": true,
      "maxItems": 20
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    }
  },
  "additionalProperties": false
}

Schema riutilizzabile con $ref

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "address": {
      "type": "object",
      "required": ["street", "city", "country"],
      "properties": {
        "street": { "type": "string" },
        "city":   { "type": "string" },
        "zip":    { "type": "string", "pattern": "^[0-9]{5}$" },
        "country":{ "type": "string", "minLength": 2, "maxLength": 2 }
      }
    }
  },
  "type": "object",
  "properties": {
    "billing":  { "$ref": "#/$defs/address" },
    "shipping": { "$ref": "#/$defs/address" }
  }
}

Domande Frequenti

Cosa sono le parole chiave JSON Schema?

Le parole chiave JSON Schema sono proprietà standard per definire tipi di dati, formati e vincoli, come $ref, properties, required e type.

Come si usa la parola chiave $ref?

La parola chiave $ref consente di fare riferimento ad altre definizioni di schema e creare componenti di schema riutilizzabili.

Qual è la differenza tra required e properties?

properties definisce le proprietà di un oggetto, mentre required è un array che specifica quali di queste proprietà sono obbligatorie.

Perché esistono più versioni di JSON Schema?

JSON Schema si è evoluto attraverso più versioni (Draft-04, Draft-07, 2019-09, 2020-12), con ogni versione che aggiunge nuove parole chiave e funzionalità.

Formattatore JSON Online Gratuito — Senza Upload Validatore JSON - Validazione sintassi & schema JSON Minifier & Compressore Online JSON Diff — Confronta oggetti JSON online Editor JSON - Strumento di Modifica JSON Avanzato Convertitore da JSON a CSV - Converti Dati JSON

Esempio di Schema Completo

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://example.com/schemas/user.json",
  "title": "User",
  "description": "A registered user account",
  "type": "object",
  "required": ["id", "email", "role"],
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 255
    },
    "name": {
      "type": ["string", "null"],
      "maxLength": 100
    },
    "role": {
      "type": "string",
      "enum": ["admin", "editor", "viewer"]
    },
    "tags": {
      "type": "array",
      "items": { "type": "string" },
      "uniqueItems": true,
      "maxItems": 20
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    }
  },
  "additionalProperties": false
}

Schema riutilizzabile con $ref

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "address": {
      "type": "object",
      "required": ["street", "city", "country"],
      "properties": {
        "street": { "type": "string" },
        "city":   { "type": "string" },
        "zip":    { "type": "string", "pattern": "^[0-9]{5}$" },
        "country":{ "type": "string", "minLength": 2, "maxLength": 2 }
      }
    }
  },
  "type": "object",
  "properties": {
    "billing":  { "$ref": "#/$defs/address" },
    "shipping": { "$ref": "#/$defs/address" }
  }
}

Domande Frequenti

Cosa sono le parole chiave JSON Schema?

Le parole chiave JSON Schema sono proprietà standard per definire tipi di dati, formati e vincoli, come $ref, properties, required e type.

Come si usa la parola chiave $ref?

La parola chiave $ref consente di fare riferimento ad altre definizioni di schema e creare componenti di schema riutilizzabili.

Qual è la differenza tra required e properties?

properties definisce le proprietà di un oggetto, mentre required è un array che specifica quali di queste proprietà sono obbligatorie.

Perché esistono più versioni di JSON Schema?

JSON Schema si è evoluto attraverso più versioni (Draft-04, Draft-07, 2019-09, 2020-12), con ogni versione che aggiunge nuove parole chiave e funzionalità.

Riferimento JSON Schema Riferimento Parole Chiave

Esempio di Schema Completo

Schema riutilizzabile con $ref

Domande Frequenti

Cosa sono le parole chiave JSON Schema?

Come si usa la parola chiave $ref?

Qual è la differenza tra required e properties?

Perché esistono più versioni di JSON Schema?

Strumenti correlati

Riferimento JSON Schema Riferimento Parole Chiave

Esempio di Schema Completo

Schema riutilizzabile con $ref

Domande Frequenti

Cosa sono le parole chiave JSON Schema?

Come si usa la parola chiave $ref?

Qual è la differenza tra required e properties?

Perché esistono più versioni di JSON Schema?

Strumenti correlati