{"_id":"5a8f1b3d9ed37a0025df14b2","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":31,"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"],"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":"5a6a26281895510045b2cd40","githubsync":"","__v":15,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-02-22T19:34:21.439Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"59a750fbd61777001b6c47ed","results":{"codes":[{"name":"without 'expand'","code":"{\n    \"items\": [\n        {\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\": \"2017-12-02T17:43:16.262Z\"\n        }\n    ]\n}","language":"json","status":200},{"name":"with 'expand'","code":"{\n    \"items\": [\n        {\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            \"serviceProperties\": {\n                \"BinarySwitch\": {\n                    \"0\": {\n                        \"switch\": \"on\"\n                    }\n                }\n            },\n            \"createdAt\": \"2017-12-02T17:43:16.262Z\"\n        }\n    ]\n}","language":"json","status":200},{"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"query\",\n            \"message\": \"field is required\",\n            \"path\": \"environmentId\"\n        }\n    ] \n}","language":"json","status":400,"name":"Environment Missing"},{"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"query\",\n            \"message\": \"field must be one of the following values: ServiceProperties\",\n            \"path\": \"expand\"\n        }\n    ]\n}","language":"json","status":400,"name":"Expand Parameter Invalid"},{"code":"{\n    \"errorType\": \"InvalidBody\",\n    \"errors\": [\n        {\n            \"path\": \"query\",\n            \"message\": \"Invalid input 'invalid' from filter 'invalid'. Expected 'AND','OR','NOR','NOT','EQUALS','NOTEQUALS','LESSTHAN','LESSTHANOREQUAL','GREATERTHAN','GREATERTHANOREQUAL','IN','NOTIN','TYPE','EXISTS','NOTEXISTS','CONTAINS','NCONTAINS' after ''\"\n        }\n    ]\n}","language":"json","status":400,"name":"Filter Invalid"},{"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"query\",\n            \"message\": \"invalid environment id\",\n            \"path\": \"environmentId\"\n        }\n    ]\n}","language":"json","status":400,"name":"Environment Invalid"},{"status":404,"name":"Environment Not Found","language":"text","code":"Environment with id E491baeae978bfbf4e2e79d22 does not exist."}]},"examples":{"codes":[{"code":"GET https://ioe.droplit.io/api/devices?environmentId=E598b82ae288b6ff4a2e89d22&filter=eq(type, \"virtual\") HTTP/1.1\nauthorization: AUTH_TOKEN","language":"http","name":"without 'expand'"},{"code":"GET https://ioe.droplit.io/api/devices?environmentId=E598b82ae288b6ff4a2e89d22&filter=eq(type, \"virtual\")&expand=ServiceProperties HTTP/1.1\nauthorization: AUTH_TOKEN","language":"http","name":"with 'expand'"},{"code":"droplit device list --environmentId E598b82ae288b6ff4a2e89d22","language":"text","name":"Droplit Console"},{"code":"droplit.devices.list(\"E598b82ae288b6ff4a2e89d22\", 'eq(type, \"virtual\")');","language":"javascript","name":"Droplit SDK"}]},"method":"get","auth":"required","params":[{"_id":"59c07ac26466f9001050945c","ref":"","in":"query","required":true,"desc":"The ID of the environment","default":"","type":"string","name":"environmentId"},{"_id":"59c07ac26466f9001050945b","ref":"","in":"query","required":false,"desc":"Expand the devices' service properties by setting to \"ServiceProperties\".","default":"","type":"string","name":"expand"},{"_id":"5b292679f11cd000039cafc3","ref":"","in":"header","required":true,"desc":"The user's authorization token.","default":"","type":"string","name":"authorization"},{"_id":"5b5b4b2feaf71700031c2a6c","ref":"","in":"query","required":false,"desc":"Get only devices whose properties fulfill the conditions of a [filter](doc:filters).","default":"","type":"string","name":"filter"}],"url":"/"},"isReference":false,"order":0,"body":"An account token, server token, or user token may be used to run this endpoint.","excerpt":"Get all the devices in an environment.","slug":"devices-list","type":"endpoint","title":"List devices."}

getList devices.

Get all the devices in an environment.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

environmentId:
required
string
The ID of the environment
expand:
string
Expand the devices' service properties by setting to "ServiceProperties".
filter:
string
Get only devices whose properties fulfill the conditions of a [filter](doc:filters).

Headers

authorization:
required
string
The user's authorization token.

Examples


Result Format


Documentation

An account token, server token, or user token may be used to run this endpoint.

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}