JSON descriptors

child.js

{
  "@": {
    "id": "http://example.org/my-obj",
    "description": "This object is described with an embedded descriptor. Other JSON-Schema properties may follow."
  },
  "prop": "value"
}

sibling.js

{
  "name": "latte",
  "@name": {
    "type": "string",
    "options": ["latte", "espresso", "americano", "cappucino"]
  },
  "quantity": 1
}

JSON Descriptors are embedded pieces of JSON-Schema or other meta-information. There are two ways of embedding a descriptor in a JSON document:

Child Notation

Insert a child @ attribute to describe the object itself.

Sibling Notation

Insert a @prop attribute to describe its sibling prop attribute.

JSON descriptors are similar to XML attributes, hence the @ prefix. They can even be used to add Microformats annotations to JSON data.