{"_id":"582789abbe5c080f00a5a813","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":"582789abbe5c080f00a5a7ff","version":"582789aabe5c080f00a5a7fe","project":"568bdc1483d2061900d86cdc","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-05T15:07:02.028Z","from_sync":false,"order":0,"slug":"documentation","title":"Getting Started"},"project":"568bdc1483d2061900d86cdc","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-07T05:45:02.051Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What is Droplit.io\"\n}\n[/block]\nDroplit.io is a device control platform to enable application development with API-based control of connected devices.\n\nWhether you’re making a smart device, or controlling buildings full of smart devices, Droplit.io allows you to orchestrate every device with a unified API.\n\nYou start by connecting a device and defining the set of [services](/docs/services) that represent the devices capabilities. Then, use the Droplit.io API to issue commands and deliver a robust connected experience with ease.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Unifying Device Control\"\n}\n[/block]\nThe devices being controlled can be connected by a hub that resides inside the local network of the device, or connected using the first-party cloud for that device.\n\nDroplit provides control of all devices through a unified API that obscures all the technical complexity and implementation differences of each device.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3969546-Concepts-simplified.png\",\n        \"Concepts-simplified.png\",\n        1266,\n        311,\n        \"#4a92f3\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"The Full Stack Solution\"\n}\n[/block]\nDroplit.io provides the full stack to develop a connected device solution including:\n - Device capability models (Services)\n - Device control REST API\n - Embedded edge software for creating hubs\n - WebSocket callbacks for building a real-time UI\n - Web Hooks for building server-side applications\n - User management and access control APIs\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Developer Portal\"\n}\n[/block]\nGo to the developer portal and create an account\n[Developer portal](http://portal.droplit.io) \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Command Line\"\n}\n[/block]\nYou can download the Droplit.io CLI from [npm](https://www.npmjs.com/package/droplit-cli)\n\n`npm install droplit-cli -g`\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Droplit Edge SDK\"\n}\n[/block]\nYou can download and run the Droplit Edge software on a almost any embedded linux devices such as a Raspberry Pi or on your desktop!\n\nGet started here: [Control smart devices at the Edge](doc:deploy-an-edge-server)\n\nSource code here: https://github.com/droplit/droplit.io-edge\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Support\"\n}\n[/block]\nThe Droplit.io Portal runs Intercom. If you have questions or problems, you can chat with support by clicking on the Intercom bubble in the lower right of the portal.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Using the docs\"\n}\n[/block]\nYou can make API requests right from the Droplit Docs.\n\nIn order to make requests, you will need an Authorization Token. You can obtain this token using the following:\n\n##Developer Portal##\nYou can view and copy your authorization token in the portal under _Manage Account_ on the ribbon.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Token Expiration\",\n  \"body\": \"If you do not select “Keep me logged in” when logging into the portal, your token will expire after a certain amount of time has elapsed. You will have to login again to obtain a new token.\"\n}\n[/block]\n##CLI##\nWhen you authenticate in the command line, your authorization token is stored in a local file _accounts.json_ which can be found in a folder called _.droplit.io_ in your home folder. This token will not expire.","excerpt":"","slug":"introduction","type":"basic","title":"Introduction"}
[block:api-header] { "type": "basic", "title": "What is Droplit.io" } [/block] Droplit.io is a device control platform to enable application development with API-based control of connected devices. Whether you’re making a smart device, or controlling buildings full of smart devices, Droplit.io allows you to orchestrate every device with a unified API. You start by connecting a device and defining the set of [services](/docs/services) that represent the devices capabilities. Then, use the Droplit.io API to issue commands and deliver a robust connected experience with ease. [block:api-header] { "type": "basic", "title": "Unifying Device Control" } [/block] The devices being controlled can be connected by a hub that resides inside the local network of the device, or connected using the first-party cloud for that device. Droplit provides control of all devices through a unified API that obscures all the technical complexity and implementation differences of each device. [block:image] { "images": [ { "image": [ "https://files.readme.io/3969546-Concepts-simplified.png", "Concepts-simplified.png", 1266, 311, "#4a92f3" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "The Full Stack Solution" } [/block] Droplit.io provides the full stack to develop a connected device solution including: - Device capability models (Services) - Device control REST API - Embedded edge software for creating hubs - WebSocket callbacks for building a real-time UI - Web Hooks for building server-side applications - User management and access control APIs [block:api-header] { "type": "basic", "title": "Developer Portal" } [/block] Go to the developer portal and create an account [Developer portal](http://portal.droplit.io) [block:api-header] { "type": "basic", "title": "Command Line" } [/block] You can download the Droplit.io CLI from [npm](https://www.npmjs.com/package/droplit-cli) `npm install droplit-cli -g` [block:api-header] { "type": "basic", "title": "Droplit Edge SDK" } [/block] You can download and run the Droplit Edge software on a almost any embedded linux devices such as a Raspberry Pi or on your desktop! Get started here: [Control smart devices at the Edge](doc:deploy-an-edge-server) Source code here: https://github.com/droplit/droplit.io-edge [block:api-header] { "type": "basic", "title": "Support" } [/block] The Droplit.io Portal runs Intercom. If you have questions or problems, you can chat with support by clicking on the Intercom bubble in the lower right of the portal. [block:api-header] { "type": "basic", "title": "Using the docs" } [/block] You can make API requests right from the Droplit Docs. In order to make requests, you will need an Authorization Token. You can obtain this token using the following: ##Developer Portal## You can view and copy your authorization token in the portal under _Manage Account_ on the ribbon. [block:callout] { "type": "warning", "title": "Token Expiration", "body": "If you do not select “Keep me logged in” when logging into the portal, your token will expire after a certain amount of time has elapsed. You will have to login again to obtain a new token." } [/block] ##CLI## When you authenticate in the command line, your authorization token is stored in a local file _accounts.json_ which can be found in a folder called _.droplit.io_ in your home folder. This token will not expire.