Scheme și metadate JSON

JSON Schema

JSON Schema prevede un format bazat pe JSON pentru a defini structura de date JSON pentru validare, documentare, și de control interacțiune. JSON Schema prevede un contract pentru datele JSON cerute de o anumită aplicație, si modul în care datele pot fi modificate.

JSON Schema se bazează pe conceptele de XML Schema (XSD), dar se bazeaza pe JSON. Schema de date JSON poate fi folosită pentru a valida datele JSON. Ca și în XSD, aceleași instrumente de serializare/deserializarea pot fi folosite atât pentru schema cât și pentru datele. Schema este auto-descriptivă.

JSON Schema este un Proiect Internet. Există mai multe validatoare disponibile pentru diferite limbaje de programare, fiecare cu diferite niveluri de conformitate.

Exemplu de JSON Schema (proiect 3):

 
{
  "$schema": "http://json-schema.org/draft-03/schema#",
  "name": "Product",
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Product identifier",
      "required": true
    },
    "name": {
      "type": "string",
      "description": "Name of the product",
      "required": true
    },
    "price": {
      "type": "number",
      "minimum": 0,
      "required": true
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "stock": {
      "type": "object",
      "properties": {
        "warehouse": {
          "type": "number"
        },
        "retail": {
          "type": "number"
        }
      }
    }
  }
}

JSON Schema de mai sus poate fi folosită pentru a testa validitatea codului JSON de mai jos:

 
{
  "id": 1,
  "name": "Foo",
  "price": 123,
  "tags": [
    "Bar",
    "Eek"
  ],
  "stock": {
    "warehouse": 300,
    "retail": 20
  }
}

Tip MIME

Tipul oficial MIME pentru text JSON este „application/json„. Cu toate că cele mai multe implementări moderne au adoptat tipul oficial MIME, multe aplicații continuă să ofere suport pentru alte tipuri MIME. Mulți furnizori de servicii, browsere, servere, aplicaţii web, biblioteci, cadre, și API-uri, folosesc sau recunosc (neoficial) tipul MIME „text/json” sau tipul de conținut „text/javascript„. Exemple notabile includ Google Search API, Yahoo!, Flickr, Facebook API, Lift framework, Dojo Toolkit, etc.