To search for devices add a query argument to the end of the /devices/ string. This will do a simple text search on the name + description fields.
The format used to search for a device is shown below.
?query=SearchPhrase
Where SearchPhrase is a word used to search by.
For example let's find devices that have "dataplicity" in their name or description:
http GET https://apps.dataplicity.com/devices/?query=dataplicity 'Authorization: Token 123456789abcdefghijklmnopqrstuvwxyzqwer'
curl --header "Content-Type: application/json" -H "Authorization: Token 123456789abcdefghijklmnopqrstuvwxyzqwer" --request GET https://apps.dataplicity.com/devices/?query=dataplicity
The response will return a list of devices, and also other details like tags and filters which should be shown to the user. The output below was manually trimmed down where the ... dots are to show only relevant details.
{
"counts": {
"final": 3,
...
},
"devices": [
{
...
"name": "Dataplicity Towers - A",
...
},
{
...
"name": "Dataplicity Towers - B",
...
},
{
...
"description": "dataplicity",
...
"name": "DeviceXY",
...
}
],
...