{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "description": "A *Thing* is a generic entity which can be used as a handle for multiple *Features* belonging to this *Thing*.",
  "title": "Thing in API v1",
  "properties": {
    "thingId": {
      "type": "string",
      "description": "Unique identifier representing the Thing, has to conform to the namespaced entity ID notation (see [Ditto documentation on namespaced entity IDs](https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id)).\n\nExamples for a valid Thing ID:\n * `org.eclipse.ditto:xdk_53`\n * `foo:xdk_53`\n * `org.eclipse.vorto_42:xdk_thing`"
    },
    "acl": {
      "title": "ACL",
      "type": "object",
      "description": "The Access Control List of this Thing containing one AclEntry for each arbitrary authorizationSubject key.",
      "additionalProperties": {
        "title": "ACL entry",
        "type": "object",
        "description": "Single Access Control List entry containing the permissions (`READ`, `WRITE`, `ADMINISTRATE`) for the Authorization Subject.",
        "properties": {
          "READ": {
            "type": "boolean",
            "description": "Whether the Authorization Subject has permissions to read this entity"
          },
          "WRITE": {
            "type": "boolean",
            "description": "Whether the Authorization Subject has permissions to write this entity"
          },
          "ADMINISTRATE": {
            "type": "boolean",
            "description": "Whether the Authorization Subject has permissions to modify this entity's Access Control List"
          }
        },
        "required": [
          "READ",
          "WRITE",
          "ADMINISTRATE"
        ]
      }
    },
    "attributes": {
      "title": "Attributes",
      "type": "object",
      "description": "The Attributes that describe this Thing in more detail. Can be an arbitrary JSON object. Attributes are typically used to model rather static properties at the Thing level. Static means that the values do not change as frequently as property values of Features."
    },
    "features": {
      "title": "Features",
      "type": "object",
      "description": "The Features belonging to this Thing. A Thing can handle any number of Features.\n The key of this object represents the `featureId`. Due to the fact that a Feature ID often needs to be set in the path of a HTTP request, we strongly recommend to use a restricted the set of characters (e.g. those for [Uniform Resource Identifiers (URI)](http://www.ietf.org/rfc/rfc3986.txt)).",
      "additionalProperties": {
        "title": "Feature",
        "type": "object",
        "description": "A Feature is used to manage all data and functionality of a Thing that can be clustered in an outlined technical context.",
        "additionalProperties": {
          "type": "object",
          "description": "The elements of a Feature.",
          "properties": {
            "definition": {
              "title": "Definition",
              "type": "array",
              "description": "The Definition of the Feature, a list of Identifiers containing at least 1 Identifier in the form 'namespace:name:version'.",
              "minItems": 1,
              "uniqueItems": true,
              "items": {
                "type": "string",
                "description": "A single fully qualified Identifier of a Feature Definition in the form 'namespace:name:version'.",
                "pattern": "(?<namespace>[_a-zA-Z0-9\\-.]+):(?<name>[_a-zA-Z0-9\\-.]+):(?<version>[_a-zA-Z0-9\\-.]+)"
              }
            },
            "properties": {
              "title": "Properties",
              "type": "object",
              "description": "The data related to a Feature is managed in form of a list of properties. Each property itself can be either a simple/scalar value or a complex object. Allowed is any JSON object."
            }
          }
        }
      }
    },
    "_namespace": {
      "type": "string",
      "description": "_(read-only)_ The namespace that is also contained in the `thingId` field (the prefix part, up to the `:`)."
    },
    "_revision": {
      "type": "integer",
      "description": "_(read-only)_ The revision is a counter which is incremented on each modification of a Thing."
    },
    "_created": {
      "type": "string",
      "description": "_(read-only)_ The created timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on creation of a Thing."
    },
    "_modified": {
      "type": "string",
      "description": "_(read-only)_ The modified timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on each modification of a Thing."
    }
  },
  "required": [
    "thingId"
  ]
}