{"_id":"582789abbe5c080f00a5a813","next":{"pages":[],"description":""},"user":"568bdbc4fe6fcc0d006dc970","api":{"params":[],"url":"","results":{"codes":[]},"settings":"","auth":"required"},"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":"","isReference":false,"link_external":false,"link_url":"","version":"582789aabe5c080f00a5a7fe","__v":0,"category":"582789abbe5c080f00a5a7ff","createdAt":"2016-07-07T05:45:02.051Z","githubsync":"","hidden":false,"project":"568bdc1483d2061900d86cdc","slug":"introduction","sync_unique":"","title":"Introduction","order":2,"parentDoc":null,"type":"basic","updates":[],"childrenPages":[]}
[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.