evalink talos
Search
K

Manage devices

Use this section to add/update/delete new sites(devices).

Introduction

Data related to devices/sites is owned and managed by the device-service. The terms site and devices can be used interchangeably. A device can either represent a single device or a site depending on the use case. However hereafter only the term device will be used.

Querying devices

get
https://talos-app.io
/api/device-service/devices/search/findByCompanyId
find all devices by companyId
get
https://talos-app.io
/api/device-service/devices/search/findByDeviceGroupId?:deviceGroupId
find the device by groupId
get
https://talos-app.io
/api/device-service/devices/:id
list a specific device

Create/Update/Delete Devices

post
https://talos-app.io/
api/device-service/devices
create a device
Example:
{
"id": null,
"companyId": "064646f3-18a2-4298-a28e-6e2883f27407",
"evalinkDeviceId": "customId",
"active": true,
"testMode": false,
"customerCompany": "Sitasys AG",
"customerFirstName": "Lukas",
"customerLastName": "Kaiser",
"customerPhone": "+41315110101",
"customerEmail": "[email protected]",
"customerZip": "4513",
"customerCity": "Langendorf",
"customerStreet": "Industriestrasse 6",
"installerCompany": null,
"installerFirstName": null,
"installerLastName": null,
"installerEmail": null,
"installerPhone": null
}
patch
https://talos-app.io
/api/device-service/devices/:id
update a device
delete
https://talos-app.io
/api/device-servicse/devices/:id
delete a device

Site activation/deactivation

post
https://talos-app.io
/api/device-service/devices/{id}/activate
activate a device
post
https://talos-app.io
/api/device-service/devices/{id}/deactivate
deactivate a device

Site sharing

under construction
Example:

Test mode

post
https://talos-app.io
/device-service/devices/:deviceId/test-mode
activate specific test mode
"matchers": [
{
"field": "string",
"invert": true,
"matcherLogic": "AND",
"operator": "string",
"type": "string",
"value": "string"
}
]

Zones/users and partitions

get
https://talos-app.io
/api/device-service/devices/:id/zones
get zones/users
post
https://talos-app.io
/api/device-service/devices/:id/zones
write zones/users
{
"zones": [
{
"zoneId": "002",
"zoneName": "John Doe",
"zoneType": "USER"
},
{
"zoneId": "001",
"zoneName": "Atrium",
"zoneType": "ZONE"
}
]
}
patch
https://talos-app.io
/api/device-service/devices/:id/zones
update zones/users
{
"zones": [
{
"zoneId": "002",
"zoneName": "John Doe",
"zoneType": "USER"
},
{
"zoneId": "001",
"zoneName": "Atrium",
"zoneType": "ZONE"
}
]
}
get
https://talos-app.io
/api/device-service/devices/:id/partitions
get partitions
post
https://talos-app.io
/api/device-service/devices/:id/partitions
write partitions
{
"partitions": [
{
"partitionId": "003",
"partitionName": "Maintenance Floor"
},
{
"partitionId": "004",
"partitionName": "Department Store"
}
]
}
patch
https://talos-app.io
/api/device-service/devices/:id/partitions
update partitions
{
"partitions": [
{
"partitionId": "003",
"partitionName": "Maintenance Floor"
},
{
"partitionId": "004",
"partitionName": "Department Store"
}
]
}

Tags

get
https://talos-app.io
/api/device-service/devices/:deviceId/tag
list tags
post
https://talos-app.io
/api/device-service/devices/:deviceId/tag
add tag
post
https://talos-app.io
/api/device-service/devices/:deviceId/untag
remove tag