{"_id":"582789abbe5c080f00a5a816","parentDoc":null,"project":"568bdc1483d2061900d86cdc","user":"568bdbc4fe6fcc0d006dc970","version":{"_id":"582789aabe5c080f00a5a7fe","__v":10,"project":"568bdc1483d2061900d86cdc","createdAt":"2016-11-12T21:29:14.915Z","releaseDate":"2016-11-12T21:29:14.915Z","categories":["582789abbe5c080f00a5a7ff","582789abbe5c080f00a5a800","582789abbe5c080f00a5a801","582789abbe5c080f00a5a802","582789abbe5c080f00a5a803","582789abbe5c080f00a5a804","582789abbe5c080f00a5a805","582789abbe5c080f00a5a806","582789abbe5c080f00a5a807","582789abbe5c080f00a5a808","5827ea984ca29e0f00137a9e","583df597887db62f00644283","583df5d9c622791900e78da5","5845cd8763c11b250037967d","5845d13063c11b2500379681","5859e859e3306d1900126725","587aeb9a01cf3a0f008359eb","587c422af45e2d0f005e200d","587d84dc82f6f30f004ceee5"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"beta2","version_clean":"0.0.0","version":"0"},"__v":0,"category":{"_id":"5845d13063c11b2500379681","__v":0,"version":"582789aabe5c080f00a5a7fe","project":"568bdc1483d2061900d86cdc","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-12-05T20:42:24.315Z","from_sync":false,"order":1,"slug":"platform-overview","title":"Platform Overview"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-12T08:11:20.084Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Introduction\"\n}\n[/block]\nDroplit.io can organize all your devices into containers that represent the geographical relationships as well as provide security access controls that understand your end-users.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Organizational Structures\"\n}\n[/block]\nDevices are stored in _Environments_ which are contained in an _Ecosystem_.\n\nAn _Environment_ represents a collection of devices in a single geographical area or all devices owned by a single user. For example: if you have a smart home product that can interface with other products in the home, your product plus the other products a user owns in the same home would be contained in one _Environment_.\n\n_Ecosystems_ represent an entire IoT project including all settings, services, apps, etc. An _Ecosystem_ can contain an unlimited number of _Environments_. While you can create an unlimited number of _Ecosystems_, you will generally only need one.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/KZb4PbjQq2MIykcYaYqw_OrgStructure.png\",\n        \"OrgStructure.png\",\n        \"839\",\n        \"689\",\n        \"#f98a13\",\n        \"\"\n      ],\n      \"sizing\": \"smart\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Ecosystems\"\n}\n[/block]\nAn **Ecosystem** is the container which houses everything including all of your environments and re-usable objects.\n\nMore on Ecosystems: [Ecosystems](doc:ecosystems)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Environments\"\n}\n[/block]\nAn **Environment** is the top-level container for devices. It is the largest scope that device commands and queries can be issued to.\n\nMore on Environments: [Environments](doc:environments)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Devices\"\n}\n[/block]\nA **Device** is the conceptual model of a connected thing. Devices can be both physical and virtual.\n\nMore on Devices: [Devices](doc:devices)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Zones\"\n}\n[/block]\nA **Zone** is a device container within an environment. Zones can contain devices or other zones. Zones cannot contain themselves or zones which contain themselves.\n\nMore on Zones: [Zones](doc:zones)","excerpt":"","slug":"ontology","type":"basic","title":"Organization"}
[block:api-header] { "type": "basic", "title": "Introduction" } [/block] Droplit.io can organize all your devices into containers that represent the geographical relationships as well as provide security access controls that understand your end-users. [block:api-header] { "type": "basic", "title": "Organizational Structures" } [/block] Devices are stored in _Environments_ which are contained in an _Ecosystem_. An _Environment_ represents a collection of devices in a single geographical area or all devices owned by a single user. For example: if you have a smart home product that can interface with other products in the home, your product plus the other products a user owns in the same home would be contained in one _Environment_. _Ecosystems_ represent an entire IoT project including all settings, services, apps, etc. An _Ecosystem_ can contain an unlimited number of _Environments_. While you can create an unlimited number of _Ecosystems_, you will generally only need one. [block:image] { "images": [ { "image": [ "https://files.readme.io/KZb4PbjQq2MIykcYaYqw_OrgStructure.png", "OrgStructure.png", "839", "689", "#f98a13", "" ], "sizing": "smart" } ] } [/block] [block:api-header] { "type": "basic", "title": "Ecosystems" } [/block] An **Ecosystem** is the container which houses everything including all of your environments and re-usable objects. More on Ecosystems: [Ecosystems](doc:ecosystems) [block:api-header] { "type": "basic", "title": "Environments" } [/block] An **Environment** is the top-level container for devices. It is the largest scope that device commands and queries can be issued to. More on Environments: [Environments](doc:environments) [block:api-header] { "type": "basic", "title": "Devices" } [/block] A **Device** is the conceptual model of a connected thing. Devices can be both physical and virtual. More on Devices: [Devices](doc:devices) [block:api-header] { "type": "basic", "title": "Zones" } [/block] A **Zone** is a device container within an environment. Zones can contain devices or other zones. Zones cannot contain themselves or zones which contain themselves. More on Zones: [Zones](doc:zones)