{"_id":"59c08604a00f90001cd75dc2","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":35,"createdAt":"2017-08-30T20:39:44.453Z","releaseDate":"2017-08-30T20:39:44.453Z","categories":["59a7236e3fe4d90025117c10","59a72eb6cb0db3001b84cfe2","59a734eb757d030019b85af8","59c0243b1b2d07001a9d2b76","59c035e42126e10028effb12","59c06c40df5b3c0010584a13","59c1a5852cabe5002641a3e7","59c2fb00b2b45c0010b7a3d7","59c32ceb9aea850010ac4130","59c32e6e190c90003cb0d12f","59c33affb2b45c0010b7aa23","59c7dfa457bd8200105444dc","59c7e975c50cf30010d712a0","59cffdef0cd4dd0010294d54","59d0622ca91a810032c8f60c","59d06733c1aec60026253065","59d174d44ac471001a07b123","59d5a5e323e6e800103defb2","59ecf1d8ed507c001c52b255","59f76fef8581dc0010593e6f","5a0c003680a35b0012c35db0","5a8358722e78660075e45f42","5a846645b5ec3a001203517e","5b258091bc7a6700033b9cb5","5b26e48e024807000315a740","5b44edff3306680003663f5c","5b468abd3d4a9e0003789111","5b468d8f3dcb6a0003c6e374","5b47b0b93d4a9e000378a33a","5b538d114ea24f00033c726f","5b6a0efe402b32000336c33f","5bba5e5d7ba7710003bd902a","5bc2703349ac3a0013eec3e5","5c351061191e2b002b4988a8","5c8b01b199b56e00440aa018"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"0.0.0","version":"0"},"category":{"_id":"59c06c40df5b3c0010584a13","project":"568bdc1483d2061900d86cdc","version":"59a72290d61777001b6c42c3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-19T01:00:48.384Z","from_sync":false,"order":19,"slug":"devices-api","title":"Devices API"},"user":"58cc41f21751ce2f003be3b7","githubsync":"","__v":7,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-09-19T02:50:44.320Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"method":"get","examples":{"codes":[{"code":"GET https://ioe.droplit.io/api/devices/D5a22e634e44f8cd804132f27 HTTP/1.1\nauthorization: AUTH_TOKEN","language":"http","name":"without 'expand'"},{"code":"GET https://ioe.droplit.io/api/devices/D5a22e634e44f8cd804132f27?expand=ServiceProperties HTTP/1.1\nauthorization: AUTH_TOKEN","language":"http","name":"with 'expand'"},{"code":"droplit device info D5a22e634e44f8cd804132f27","language":"text","name":"console"},{"code":"droplit.devices.info(\"D5a22e634e44f8cd804132f27\");","language":"javascript","name":"Droplit SDK"}]},"results":{"codes":[{"name":"without 'expand'","code":"{\n \"id\": \"D5a22e634e44f8cd804132f27\",\n \"ecosystemId\": \"C59eb8eae278b6bf402e39d25\",\n \"environmentId\": \"E598b82ae288b6ff4a2e89d22\",\n \"type\": \"virtual\",\n \"alias\": \"Light\",\n \"meta\": {\n \"$label\": \"Light\"\n },\n \"label\": \"Light\",\n \"services\": [\n \"BinarySwitch\"\n ],\n \"createdAt\": \"2018-08-01T23:23:53.512Z\"\n}","language":"json","status":200},{"name":"with 'expand'","code":"{\n \"id\": \"D5b624109def4f50ca4a7be08\",\n \"ecosystemId\": \"C59434aae4ca2fb182b7af191\",\n \"environmentId\": \"E5b623bb9def4f50ca4a7bd7e\",\n \"type\": \"virtual\",\n \"alias\": \"Light\",\n \"meta\": {\n \"$label\": \"Light\"\n },\n \"label\": \"Light\",\n \"services\": [\n \"BinarySwitch\"\n ],\n \"serviceProperties\": {\n \"BinarySwitch\": {\n \"0\": {\n \"switch\": \"off\"\n }\n }\n },\n \"createdAt\": \"2018-08-01T23:23:53.512Z\"\n}","language":"json","status":200},{"code":"{\n \"errorType\": \"InvalidParams\",\n \"errors\": [\n {\n \"in\": \"path\",\n \"path\": \"id\",\n \"message\": \"invalid id\"\n }\n ]\n}","language":"json","status":400,"name":"Device Invalid"},{"code":"{\n \"errorType\": \"InvalidParams\",\n \"errors\": [\n {\n \"in\": \"query\",\n \"path\": \"expand/0\",\n \"message\": \"value 'invalid' is not defined in enum\"\n }\n ]\n}","language":"json","name":"Expand Parameter Invalid","status":400},{"code":"Device with id D5be247091efcf59ca4a78e01 does not exist.","language":"text","name":"Device Not Found","status":404}]},"settings":"59a750fbd61777001b6c47ed","auth":"required","params":[{"_id":"59c08604a00f90001cd75dc3","ref":"","in":"path","required":true,"desc":"The ID of the desired device.","default":"","type":"string","name":"id"},{"_id":"5b8848e7f991b60003519cb5","ref":"","in":"query","required":false,"desc":"Expand either the devices' service properties by setting to \"ServiceProperties\".","default":"","type":"string","name":"expand"},{"_id":"5b8848e7f991b60003519cb4","ref":"","in":"header","required":true,"desc":"The user's authorization token.","default":"","type":"string","name":"authorization"}],"url":"/:id"},"isReference":false,"order":2,"body":"An account token, server token, or user token may be used to run this endpoint.","excerpt":"List the information of a particular device.","slug":"devices-info","type":"endpoint","title":"Get a device."}getGet a device.
List the information of a particular device.
Definition
{{ api_url }}{{ page_api_url }}
Parameters
Path Params
id:
required
string
The ID of the desired device.
Query Params
expand:
string
Expand either the devices' service properties by setting to "ServiceProperties".
Headers
authorization:
required
string
The user's authorization token.